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Chapter 1. Introduction and overview 



OS/2 Warp Server for e-business is the entry-level member of the IBM family 
of scalable server platforms and builds on OS/2 Warp Server’s 10-year track 
record for mission-critical applications in providing a reliable foundation for 
network computing and complex e-business solutions. 

OS/2 Warp Server for e-business is Year 2000 ready, supports eurocurrency, 
and, when packaged with WebSphere and Lotus Domino Go, is able to 
provide content-rich Web sites with strong enterprise host systems 
interoperability. 

This chapter will describe the transformation of OS/2 Warp Server for 
e-business, a summary of the features, the systems requirements, and the 
installation process. 



1.1 Evolution 

Over time, computing trends change. Technology choices made by 
individuals and corporations are based on potential immediate and long-term 
benefits. These choices are influenced by a number of factors. Historically, it 
appears that the economics of any technology is the most significant factor. 
Both the related costs and the return on investment are important factors. 

This section will describe the major trends in computing and describe how 
OS/2 Warp Server for e-business fits into the current computing paradigm. 

1.1.1 Host computing: 1 964 

At one time, computing was defined by the host. These machines were 
controlled by specialists in large businesses and institutions who understood 
the emerging field of electronic computing. Host computing, in its heyday, 
was all about centralized everything: Centralized computing power, 
centralized administration, centralized decision-making. The high cost of 
computing at the time did not allow for a distributed architecture. 
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Figure 1. Centralized host computing 

Centralization has some significant benefits: With everything centralized, it 
was easier to build, deploy, and manage new applications. The IBM 
mainframe became the de-facto work horse of the airline industry, banking 
industry, retail industry, and dozens of others that harnessed enterprise 
computing for data processing and transactions. The minicomputers that 
became popular in the 70s and UNIX systems are both variations of host 
computing. 

1.1.2 Personal computing: 1981 

Personal Computing was made possible by the advent of the microprocessor, 
a computer on a single chip. The personal computer radically changed the 
face of information technology not by marginalizing host systems but by 
opening up new uses and new markets for computing. 




Figure 2. Personal computing 
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At the price point, although much higher than it is today, the PC era put 
information technology into the hands of millions of individuals. Computing 
was suddenly affordable. It could be bought from retail outlets, over the 
phone, or online. Applications came in a box. What this era accomplished, 
more than anything else, was to make consumers and end users more savvy 
about and more open to what computing could help them achieve. But, this 
model was not without its flaws. 

1.1.3 Client/Server: 1988 

Client/server attempted to bridge the gap. The imperfection of the PC era was 
that PCs were islands of computing, disconnected from mainframes and other 
enterprise systems. Valuable data, applications, and services on these larger 
systems were inaccessible to users on PCs, and the valuable information 
stored on PCs could not be shared with other users. Client/server computing 
attempted to rectify this. It envisioned a world of enterprise systems serving 
data and applications to client PCs, and it promised universal connectivity 
between any client and any server. Client/server gave us powerful new 
applications like groupware, which supports collaboration. 




Figure 3. Client/Server computing, connected but proprietary 
But, there are disadvantages. 

• A number of client side platforms exist, each with its own set of APIs. This 
means that client side applications written for one platform will not work on 
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other platforms. To support multiple clients requires multiple copies of the 
client side application. 

• The cost of managing the clients are high. Both the operating system and 
the application needs to be maintained. Also, as new releases of the 
operating system and applications become available, more powerful 
hardware has to be purchased and deployed. 

• The client side also requires complex administration with much of the 
functionality of the solution down at the client. This problem is not so 
evident with a small number of localized machines but becomes a major 
problem when a large number of machines are distributed. 

• Designing client/server applications is complex. 

1.1.4 Network computing: The world today 

Network Computing is a new model of computing that is taking the world by 
storm. By definition, it is a network-based style of computing based on 
seamless access to information and applications. 

It is different from traditional computing in that the applications and data the 
user accesses reside on servers rather than PCs. The connection is provided 
by a network. Because network computing is based on standards like the 
Internet protocols and Java, most of the world's computers can, for the first 
time, communicate and share applications and data even though they are 
made by different companies and run different operating systems. And, 
because the heavy workload of computing shifts to servers, entirely new 
end-user access devices are now possible: Everything from Web-enabled 
TVs and personal digital assistants to screenphones and smartcards. 

This computing model brings significant relief to the problems experienced 
with client/server implementations. This is mostly due to the high rate of 
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adoption of Internet technologies. Having large numbers of people adopt a 
technology brings the costs down making it accessible to even more. 

Seemingly overnight, the Internet and the World Wide Web have delivered on 
the promise of any client to any server. Now, anyone using a PC who wants 
access to information on another computer can get it as long as the 
computing systems adhere to the technical standards of the Internet (and the 
vast majority of computers today do). Not only can the world's computers talk 
to each other and share data, they can support transactions of all kinds 
effortlessly and inexpensively. And, with the Java programming language, 
they can share applications as well. 




Figure 4. Network computing, open connectivity 

The reason we believe this era of network computing is going to last for a 
long time is that it builds upon the advantages of all the eras that have come 
before while eliminating virtually all of their downsides. It recentralizes the 
development and deployment of applications. As in the host computing era, 
applications are centrally deployed and managed. At the same time, network 
computing actually expands the freedom individuals gained during the PC era 
by conceptually giving them access to every individual, business, and 
institution in the world. Finally, network computing offers the collaboration and 
connectivity that the client/server era promised but never delivered. 
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1.1. 4.1 Pervasive computing 

By the year 2000, it is estimated that more than 40 percent of the access to 
the Net will be via devices that are not PCs-PDAs, web-based televisions, 
kiosks, or small devices. Truly, pervasive computing is what will happen when 
devices disappear and chips and tiny disk drives become embedded in 
things, such as our cars, machine tools, appliances, houses, even clothing. 
This will make possible a new class of application: online services that are 
interwoven into the fabric of people's lives. The opportunity is enormous for 
consumers and for the businesses that will provide those applications. 

1.1. 4. 2 Deep computing 

The story gets more profound. All of these devices will enable companies to 
amass valuable data. Every one of these things connected to the Net will be 
able to transmit information. So, for instance, a car manufacturer will be able 
to gather data about how consumers use their vehicles. Here is where deep 
computing comes in. It is the astonishing combination of ultrafast computing 
combined with sophisticated analytical software. It will enable companies to 
analyze, find patterns, and take action on all the data they have gathered. 



1.2 Overview 

When the first PC’s were introduced, they were stand-alone. The high cost of 
disk space and printers introduced the concept of a server. One of the most 
popular network services was file and print sharing. The server’s hardware 
architecture was similar to that of the PC client, but the software was not. 
Network Operating Systems, as they were known, were available from 
vendors, such as IBM, Novell, Microsoft, and Banyan Vines. 

In 1 984, just a few years after the introduction of the IBM Personal Computer, 
IBM announced the IBM PC Network Program software designed to allow 
peer-to-peer communications and resource sharing in a DOS environment 
among IBM PCs. The product evolved into OS/2 LAN Server, and then into 
OS/2 Warp Server. OS/2 Warp Server was the first to introduce an extensive 
range of application services. The newest member of that family, OS/2 Warp 
Server for e-business, further extends the set of application services that are 
provided. 

1.2.1 About e-business 

The current computing model, namely, network computing, as we defined it, 
is a network-based style of computing based on seamless access to 
information and applications. 
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e-business describes the customer benefits of network computing. It is about 
transforming key business processes with Internet technologies. 

e-business embraces e-commerce (buying and selling over the Net), but it is 
more than that, e-business includes intranet applications that let employees 
better manage their knowledge and operations, extranets that transform the 
way an organization works with its suppliers, distributors and partners, and 
the very important noncommercial Web applications in education, healthcare, 
and government. In sum, an e-business is any company or institution that 
conducts its core business via the Internet. 

e-business is any activity that connects critical business systems directly to 
their critical constituencies (customers, employees, vendors and suppliers) 
via intranets, extranets and over the World Wide Web 

In general, most people understand e-business as doing business 
electronically. There has been a lot of talk about network computing, 
e-business and e-commerce, and, while the terms are not synonymous, there 
is overlap between them, e-business is a subset of network computing that is 
a broader concept than e-commerce. 

This is e-business - where the strength and reliability of traditional 
information technology meet the Internet. This new Web + IT paradigm 
merges the standards, simplicity, and connectivity of the Internet with the 
core processes that are the foundation of business. The new killer apps are 
interactive, transaction intensive, and let people do business in more 
meaningful ways. 

In order to support e-business, a server must possess the necessary 
application-level software to allow a customer to leverage the network 
computing model. These layers have now been added to OS/2 Warp Server, 
thus the name OS/2 Warp Server for e-business. 

OS/2 Warp Server for e-business consolidates previous OS/2 Warp Server 
V4 releases into a single CD-media package. Current OS/2 Warp Server V4.0 
FixPaks and current OS/2 Warp Server V4.0 Software Choice features are 
rolled into the product including Year 2000 and euro currency readiness, Java 
and Netscape, as well as improved TCP/IP. Also included are Netfinity V5.2, 
LDAP Client, Dynamic IP Client for Win95 and NT, and OS/2 Warp Server 
Backup/Restore V6.0. And, the new JFS delivers increased server reliability. 
Seamless Windows NT Server Management, which allows Windows NT 4.0 
servers to be seamlessly integrated into a network, fortifies OS/2 Warp 
Server for e-business’s capability in mixed environments. Industry standard 
support for Intelligent Input/Output (120) adapters for SCSI disks and LAN 
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Ethernet and token ring is also planned. What this adds up to is a powerful 
mission-critical foundation for the e-business transformation. The Server’s 
features are designed to meet the more rigorous performance and availability 
requirements of universal access. It can facilitate the transition to network 
computing and the Java Application Model with the Java and LDAP toolkits. 
Yet, its support of existing OS/2 applications and eased administration of 
Windows platforms can preserve existing investments. And, most definitely, it 
is the optimum platform for Workspace On-Demand, which is a proven IBM 
product for reducing cost of ownership, speeding deployment of new 
applications, and transitioning to network computing. OS/2 Warp Server for 
e-business is the definitive Intel server in a comprehensive computing 
infrastructure that meets today's and tomorrow's demanding requirements. 

1.2.2 Architecture and services 

The figure below is a high-level view of the architecture of OS/2 Warp Server 
for e-business. Built into the base operating system is support for a number of 
file systems. Communication support is also tightly integrated into the base. 
Each of the services that the server can provide runs as an application on top 
of the base operating system. Services can be selected during installation 
depending on the tasks you require the server to perform. 
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Figure 5. OS/2 Warp Server for e-business, high-level architecture 

1.2. 2.1 Base operating system services 

The base operating system for OS/2 Warp Server for e-business is an 
advanced, multitasking, 32-bit operating system that runs DOS, Windows, 
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and OS/2 16 and 32 bit applications and utilizes SMP hardware 
configurations. 

The base operating system interface is based on the intuitive OS/2 Warp 4.0 
interface making it easy for a system administrator to perform server tasks. 

Memory support has been enhanced. Applications running on the server can 
access a virtual memory address space of up to 3GB. 

The base operating system also boasts some significant new server level 
features. 

• A new 32-bit SMP-enabled Kernel Execution Environment (KEE) significantly 
improves the SMP scalability of the product. 

• The server includes support for both the uniprocessor and Symmetric 
Mutiprocessor (SMP) support. SMP support is optimized for 8-way CPUs 
with support within the architecture for up to 64-way systems. 

• Two new OS/2 kernel APIs that allow OS/2 applications to specify which 
processor they would like to run on in a multiprocessor environment. 

• Security Enablement Services (SES) and Kernel Program Interfaces 
(KPIs) previously available in FixPaks are included. Both the uniprocessor 
and SMP versions of SES are available in the base. In addition, there are 
modified KPI’s for supporting files greater than 2GB in size. 

Large files greater than 2GB in size are now supported. 

The base operating systems include support for Intel’s intelligent I/O (l 2 0) 
ethernet, token-ring, and SCSI specifications. The l 2 0 architecture is an 
emerging standard for the development of device drivers. The architecture 
enables adapters to run driver functions that process transactions that are 
normally handled by the CPU, thus, decreasing the CPU utilization. 

These and other enhancements are discussed in more detail in Chapter 2, 
“Base operating system enhancements” on page 23. 

1.2. 2. 2 Adapter and protocol services 

OS/2 Warp Server for e-business provides you with a wide rage of supported 
networking protocols and communication adapters that you may use in many 
combinations to suit your requirements. This is for a server system in a LAN 
environment as well as for wide area networking. Adapters and Protocol 
Services may be called the communications engine of OS/2 Warp Server for 
e-business since it provides the communication support for all the other 
components of this product. 
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This is discussed in more detail in Chapter 3, “Adapters and protocol 
services” on page 53. 

1.2. 2. 3 File and print 

The File and Print Sharing services component of OS/2 Warp Server for 
e-business is a local area network (LAN) application used to share hardware 
and software resources that are located on the server machine. 

Despite the increasing popularity of web-based applications, file and print 
services are still commonplace in many of today’s work environments. Some 
of the enhancements in File and Print Services include: 

• Windows NT User Account manager: This enables administrators to 
manage user IDs on Windows NT Server systems that are defined as 
additional servers in the OS/2 Warp Server domain. The User Account 
Manager function lets administrators consolidate the administration of 
both NT Server-based additional servers and OS/2 Warp Server-based 
systems into a single interface, thus, saving time. 

• Windows 95/NT client support: The popularity of clients running 
Windows95 and Windows NT has increased greatly throughout the 1990s. 
Although these clients are compatible with OS/2 Warp Server, IBM has 
released applications to enable these clients to become full participants in 
the domain, which includes support for IBM-based enhancements, such 
as aliases, logon assignments, and disk limits. 

IBM has also increased the maximum numbers allowable for some resources 
within the File and Print Services component, such as MAXSEARCFIES, 
MAXSHARES, MAXCONNECTIONS, and MAXOPENS. This enables OS/2 
Warp Server for e-business to continue to scale even higher than it could 
before making it the ideal choice for enterprise customers. 

1.2. 2. 4 TCP/IP services 

TCP/IP services have been part of OS/2 Warp Server since the Version 4 
release in 1996. Since this time, many enhancements in function and 
usability have been incorporated into subsequent TCP/IP Services releases. 
OS/2 Warp Server for e-business includes the latest version of TCP/IP, 
Version 4.2.1. Some of the highlights and improvements are: 

• 32-bit enablement: Since Version 4.1 , IBM has enhanced TCP/IP for 32-bit 
APIs. These can provide better throughput because of 32-bit data 
grouping. 

• New file APIs: Applications that manipulate, send, and receive files, such 
as web servers, will see better performance through new send_file() and 
accept_and_recv() APIs. 
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• Enhanced daemons: The File Transfer Protocol Daemon (FTPD) is 
enhanced for multi-threading for better performance. It also supports the 
restart of broken connections. The Trivial File Transfer Protocol Daemon 
(TFTPD) is also multi-threaded and supports block sizes of up to 8 KB. 
There is also a security mechanism that enables the administrator to 
restrict access to certain directories for TFTP clients. The line printer 
daemons, LPD and LPRPORTD, now have Streaming support to enable 
IBM Network Station clients to use OS/2-based print servers. 

• NFS client and server support: The Network File System, previously 
available in TCP/IP Version 2.0, is enhanced and included. This NFS is a 
32-bit implementation that is ready for supporting the IBM Network 
Station. In addition, the administrator can mount NFS shares on 
UNIX-based systems and redirect these shares locally using NETBIOS, 
thus acting as an NFS gateway for OS/2 Warp Server clients that do not 
have NFS client support installed. 

• DHCP and DDNS support: These services have been enhanced 
significantly over the past few years. The inclusion of a BINL server that 
supports Intel Wired for Management specifications is new. For a good 
description of the architecture and implementation of DHCP and DDNS in 
IBM products. Refer to the redbook Beyond DHCP - Work Your TCP/IP 
Internetwork with Dynamic IP, SG24-5280. 

• VPN support: This function allows the administrator to create a Virtual 
Private Network (VPN) between two OS/2 systems running TCP/IP 
Version 4.1 or higher. The IP-filtering function of VPN also enables the 
administrator to create a mini-firewall. For more exhaustive information 
about VPN, refer to the redbook A Comprehensive Guide to Virtual Private 
Networks, Volume 1 : IBM Firewall, Server and Client Solutions, 
SG24-5201 . 

This is discussed in more detail in Chapter 7, “TCP/IP Version 4.21 new 
functions” on page 225. 

1.2. 2. 5 Remote access services 

In OS/2 Warp Server Version 4, IBM included the ability for OS/2 and 
Windows systems to dial into a Remote Access Server to access resources 
as if the remote clients were actually on the LAN. This function was provided 
by the LAN Distance program. Since this time, IBM has also added a 
Point-to-Point Protocol (PPP) server and the ability for any PPP client to 
connect to it. PPP clients include the IBM 8235 Dialer, Windows 95/98, 
Windows NT Remote Access, and Shiva PPP. 
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This PPP server and client support has been included in OS/2 Warp Server 
for e-business. Remote Access Services has also been enhanced to provide 
client support for the dynamic assignment of IP address known as dynamic IP. 

This is discussed in more detail in Chapter 9, “IBM remote access services” 
on page 359. 

1.2. 2. 6 Systems management 

IBM has a long history in the Systems Management area on many computing 
platforms. On the Intel platform, the original systems management function in 
OS/2 Warp Server Version 4 was provided by OS/2 SystemView. With the 
release of the OS/2 Warp Server SMP Feature, the Netfinity server function 
was introduced. OS/2 Warp Server for e-business now includes Netfinity 
Version 5.2. 

Also new in OS/2 Warp Server for e-business is the inclusion of a Tivoli 
Management Agent (TMA). This TMA enables the server to become a 
managed object in the Tivoli Managed Environment, a very popular 
cross-platform systems management framework. 

1.2. 2. 7 Backup and recovery 

Warp Server for e-business includes PSnS Version 6.01 . This component 
allows the backup of applications, data, and access controls to diskette, tape, 
local and remote hard disks, optical disks, and the ADSTAR Distributed 
Storage Manager (ADSM) server on any platform. This version has more 
hardware device support and includes the following major enhancements: 

• Usability: IBM has enabled PSNS to support backup and restore 
procedures written in C and REXX through the corresponding APIs (see 
the online documentation for more details). 

• Additional media: PSnS now supports backup to removable partitioned 
media, such as the Iomega JAZ and ZIP drives. 

• Dual device backup sets: PSnS allows the first backup to be on one type 
of media and subsequent incremental backups to be stored on a different 
type of media. This enables administrators to select the best backup 
solutions for their specific environment. 

• Support for files greater than 2GB in size. 

• Support for restoring backups taken with older versions of PSnS. 

1.2. 2. 8 Advanced print services 

The Advanced Print Services of OS/2 Warp Server for e-business are still 
based on Print Services Facility/2 (PSF/2). PSF/2 allows the administrator to 
define print conversion transforms for HP-PCL, PPDS, Postscript and 3270 
host data streams. One major feature of Advanced Print Services is the ability 
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to print postscript output on non-postscript printers. With Advanced Print 
Services, it is also possible to print large PC-based jobs onto host printers 
with the Upload and Print function. 

1.2. 2. 9 Filesystems 

As you already know, OS/2 Warp Server Version 4 supports the FAT, HPFS 
and HPFS386 file systems, which have existed for several years now. OS/2 
Warp Server for e-business supports these as well as a new file system 
called the Journaled File System (JFS). Let us describe each one briefly to 
refresh your memory, and then we will discuss JFS in more detail. 

FAT 

The File Allocation Table used a linear search mechanism to find files, which 
became very slow as hard disks grew in size and the number of files in a 
directory increased. FAT dates back to the early days of DOS and is still 
supported as a bootable file system primarily for backwards compatibility and 
data interchange. Installation of OS/2 Warp Server for e-business on a FAT 
partition is, generally, not recommended. 

HPFS 

The High Performance File System is another bootable file system that is 
supported in OS/2 Warp Server for e-business. HPFS is preferred over FAT 
because of the many enhancements in speed and reliability that were made. 
JFS (see Section 1 .3.2.4 below) is faster than HPFS and offers better 
scalability, caching and shorter recovery times. Thus, it can replace HPFS in 
all applications except the boot partition. 

HPFS386 

HPFS386 contains a Ring 0 SMB server. This means that the transfer of data 
from the HPFS386 cache to the network adapter driver occurs much more 
quickly. HPFS386 is best used for file serving and for 802.2 Remote Initial 
Program Load (RIPL) of DOS, OS/2, and Workspace On-Demand RIPL 
clients. As of this writing, it is also the only choice if you need DASD limits or 
the Fault Tolerance Feature since (as of the writing of this redbook) JFS does 
not implement these. Before installing over a machine with HPFS386, you 
have to remove the HPFS386 DASD limits and access controls (ACLs) as 
well as the Fault Tolerance from the target volume. 

JFS 

JFS, a 32-bit file system, is especially suited for application servers, such as 
hosting the data of a Web server or a Lotus Notes server. JFS can be used to 
replace HPFS in most cases. It offers larger and faster caching capabilities 
and improves performance over HPFS. Currently, JFS is the only file system 
in OS/2 Warp Server for e-business that can be extended by adding more 
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partitions to a volume, thus, increasing available file space. JFS also offers 
better performance and scalability on SMP machines due to the changes in 
the I/O subsystem and features special optimizations for IP-based services. 
Similar to 386HPFS cache, JFS cache does not have a specific maximum; it 
is dependent on the amount of real memory installed on the system. The 
default is set to 1/8 of memory, but this default may be overridden by the 
Tuning Assistant (in the case of an attended installation). The memory used 
by JFS cache is allocated from the system arena and is non-swappable. JFS 
also includes the following capabilities: 

• Unicode support 

• Variable block size (512 - 4096 bytes) 

• Extended filename support (254 characters) 

• Online volume expansion 

• Online defragmentation 

• Sparse file support 

1.2.2.10 Lightweight Directory Access Protocol (LDAP) 

LDAP is a mechanism used for communicating with servers that provide 
global directory functions, sometimes called Yellow Pages after the telephone 
books that list all business in a particular area in alphabetical order. OS/2 
Warp Server for e-business includes an LDAP client, which allows it to send 
and receive directory information from an LDAP server. 

1.2.2.11 Webserver 

OS/2 Warp Server for e-business includes Lotus Domino Go Webserver 
4. 6. 2. 6. Lotus Domino Go Webserver is a scalable high-performance Web 
server that is easy to install and maintain. It includes state-of-the-art security, 
site indexing capabilities, and support for JDK 1.1.x. Lotus Domino Go 
Webserver makes it possible to maintain a productive Web presence in a 
diverse and dynamic environment. 

1.2.2.12 Java application server 

After you install Lotus Domino Go Webserver, you can add Java support by 
installing IBM WebSphere Application Server 1.1. IBM WebSphere 
Application Server is a plug-in for Lotus Domino Go Webserver and includes: 

• A Java servlet engine that implements the JavaSoft Java Servlet API 

• IBM additions and extensions to the Java Servlet API for enhanced 
session tracking and personalization 

• Support for JavaServer Pages (JSP) is a powerful approach to dynamic 
Web pages 

• A database connection manager for caching and reusing connections to 
JDBC-compliant databases 
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• Data access JavaBeans (additional Java classes for accessing 
JDBC-compliant databases) 

• CORBA Support — an object request broker (ORB) and a set of services 
that are compliant with the Common Object Request Broker Architecture 
(CORBA) 



1.3 A versatile server 

As described in the previous section, OS/2 Warp Server for e-business 
supports a number of application services. This section describes just some 
of the more common environments where the server can be deployed: 




Figure 6. OS/2 Warp Server, deployment into a number of distinct environments 

1. Communications Gateway 

Many enterprise environments have large mainframes, midrange 
computers, or minicomputers that store and process large amounts of 
mission-critical data. With additional Communications Server software, 
OS/2 Warp Server for e-business can act as a gateway to the many client 
machines that require access to corporate data-processing centers. 

2. File and Print Server 
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In a more traditional role, OS/2 Warp Server for e-business is often used 
to share hardware resources, such as disk space and printing. Users can 
share data, applications, and network devices. 

With the separately purchasable 386 HPFS, OS/2 Warp Server for 
e-business provides world-class file and print performance for large 
enterprise environments. 

3. Web Servers 

OS/2 Warp Server for e-business comes with all of the necessary software 
to set up simple or highly complex web sites. It provides unparalleled 
performance and reliability at extremely low cost. 

The latest OS/2 Java implementation (Java 1 .1 .7 based) provides 
state-of-the-art Java performance integrated into OS/2. Significant 
enhancements to HTTP related APIs allow the server to handle a wider 
number of connections much faster. 

These improvements allow customers the potential to combine 
high-capacity, high-performance web-serving and Java serving. 

4. Remote Access Server/ISP 

To enable mobile workers to gain access to corporate data or Internet 
Service Providers(ISP’s) to set up a robust dial in infrastructure, OS/2 
Warp Server for e-business comes with Remote Access Services. This 
feature offers users a wide variety of remote client access support and 
offers new levels of performance and security plus a low cost of 
ownership. 

5. Mail Server 

With Lotus Notes, OS/2 Warp Server is able to support thousands of users 
without forsaking performance or reliability. 

Benchmarks indicate that OS/2 Warp Server with Notes provides a high 
performance server capability. It shows that this system provides 
outstanding price/performance and highly cost-effective solutions to 
customer's Notes server needs making it the optimum choice as a Notes 
Server platform for most customers. 

6. Workgroup Systems Management 

As workers become more and more dependent on their computers, it is 
imperative that they are carefully managed. With Netfinity Manager and 
Client Services included, OS/2 Warp Server for e-business gives network 
administrators the visibility and capabilities they need to initiate and 
manage services for LAN-connected clients and servers. Netfinity for 
OS/2 is the ideal solution for departmental server/client management. 



16 Inside OS/2 Warp Server for e-business 




7. Database Server 

With DB2 Universal Database, OS/2 Warp Server for e-business extends 
into a powerful, reliable, Database server with universal client connectivity. 

DB2 Universal Database version 5.2 runs on Windows NT, Windows 95/98 
(Personal Edition only), OS/2, AIX, Hewlett-Packard HP-UX, Sun Solaris, 
and UnixWare 7. Client access is provided from these platforms plus DOS, 
Apple MacOS and Silicon Graphics IRIX, plus Web access with popular 
browsers and Java applications using DB2's native Java/JDBC support. 

8. Server-Managed Clients 

OS/2 Warp Server for e-business is the premier platform for Workspace 
On-Demand, an IBM thin client offering. Customers who are deploying 
Workspace On-Demand have found that it reduced their client ownership 
costs, expedited deployment of new applications, and supported their 
transformation to the e-business application model while allowing them to 
maintain and use their existing OS/2 applications. 

Workspace On-Demand now supports a diverse set of clients including 
Windows NT workstation, Windows 98, Windows 95, and OS/2. 

9. Collaborative Application Server 

Together with Domino, OS/2 Warp Server for e-business provides a 
complete and powerful platform for building secure collaborative Web 
applications. The Domino Application Server is an open secure platform 
optimized to deliver collaborative Web applications. These applications 
can be used to integrate your enterprise systems and allow for rapidly 
changing business processes. 



1.4 System requirements 

Prior to installing OS/2 Warp Server for e-business, make sure you have the 
required hardware and software and that your hardware is supported by OS/2 
Warp Server for e-business. 

You can find the most current information on supported hardware and 
additional device support on the Internet at the following Web site: 

http: //www. software . ibm.com/os/warp/ support 

The Personal Computer Manufacturer (PCM) table lists systems that have 
been tested and verified to work with OS/2. The PCM table is available at the 
following Web site: 

http: //www. software . ibm.com/os/warp/hw-cert 
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New hardware that becomes available after OS/2 Warp Server for e-business 
is installed can be supported with modifications to the diskettes used to start 
the installation process. You can find the most current information about 
additional device drivers on the Internet at the following Web address: 

http : //service . software . ibm . com/os2ddpak/index . htm 



1.4.1 Hardware requirements 

To install OS/2 Warp Server for e-business and use its services on the server, 
you need at least the following minimum hardware: 

1. One or more Intel-compatible Pentium or higher processors with a speed 
of at least 133 MHz. 

Note 

A multiprocessor system must either comply with the Intel Multiprocessor 
Specification, Version 1 .4 or 1 .1 , or it must be one of the following 
computers, each of which has its own proprietary SMP architecture: 

• Compaq Proliant 2000 

• Tricord PowerServer, models 30 and 40 

• IBM PC Server 720 

If this is not applicable to your system, your hardware manufacturer 
might have written its own *.PSD driver file to support OS/2 Warp Server 
for e-business SMP on his hardware. Check ahead of time to see 
whether such support is available. 



2. You need a minimum of 32MB of random access memory (RAM), but 
64MB or more provides better performance, depending on which services 
are installed. 

3. A minimum of 120MB of available hard disk space for the base operating 
system. A minimum of 200MB is required for the base operating system 
and all default installation items. A total of 500MB is recommended for a 
typical installation depending on which services and components are 
installed. For installation requirements of services and components, see 
the table in section 1.4.2 “Hard Disk Space Requirements”. 

4. A 1.44MB 3.5-inch diskette drive configured as drive A. 

5. 640 x 480 (16-color) or higher resolution VGA display. 

6. An IBM-compatible mouse. 

7. A CD-ROM drive supported by OS/2. 
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8. A LAN adapter card supported by MPTS. 

9. Remote Access Services requires the supported remote access adapters, 
which are a subset of the supported MPTS LAN adapters. 

10. A modem that supports speeds of 9600bps or higher if you plan to use 
RemoteAccess Services. 

1 1 .An Internet-enabled LAN or a modem if you plan to use the Internet. 

1.4.2 Hard space disk requirements 



The requirements in this section are based on information available at 
publication time. 

Table 1. OS/2 Warp Server for e-business, disk space requirements 



Service 


Hard Disk Space 
Requirements (MB) 


OS/2 Base Operating System 
All optional OS/2 components 


180.0 


File and Print Sharing Services 


15.0 


TCP/IP Services 


30.0 


Remote Access Services 


6.0 


Netscape Communicator 


11.0 


Tivoli Management Agent 


1.5 


Personally Safe ’n’ Sound 


7.2 


LDAP Services Toolkit 


4.2 


Advanced Print Services 


54.0 


First Failure Support Technology (FFST) 1.2 


0.1 


Online Books 


10.0 


Total (if all components and services are installed) 


439.0 



1.4. 2.1 Keyboards supported during installation 

For SBCS versions of OS/2 Warp Server for e-business, code page 850 is the 
only code page that is supported during the first phase of the installation 
process or if you start the system from utility diskettes. As a result, you must 
select one of the Latin-1 keyboards even if you normally select a non-Latin-1 
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keyboard. You can still set the country code to any valid country. This setting 
may affect the default country and keyboard settings used later in the 
installation process, including those used by the Logical Volume Management 
Tool (LVM), and for command line processing when the system is booted from 
utility diskettes. However, later in the installation, you can specify your 
preferred country and keyboard settings. 



1.5 Replaced or discontinued components 

The following components, previously installed with OS/2 Warp or OS/2 Warp 
Server, are replaced in OS/2 Warp Server for e-business: 

1. The Fixed Disk Utility (FDISK.COM) is replaced by the Logical Volume 
Management Tool (LVM. EXE). The Fixed Disk Presentation Manager 
Utility (FDISKPM.EXE) is replaced by Logical Volume Manager Graphical 
User Interface (LVMGUI.CMD). 

2. Java 1 .0 is replaced by Java 1 .1 .7. 

3. Pulse is replaced by CPU Monitor (CPUMON). 

4. LAN Distance is superseded by Remote Access Services. 

5. SystemView Agent (Netfinity TME 10) is replaced by Tivoli Management 
Agent (TMA). 

The following components previously installed with OS/2 Warp or OS/2 Warp 
Server are not part of OS/2 Warp Server for e-business: 

• Password Coordinator. 

• Network Signon Coordinator. 

• BonusPakOS/2 Warp Tutorial. 

• OpenDoc. 

• WarpGuide. 

• VoiceType. 

• Hibernate (Trapdoor). 

• Novell NetWare Client for OS/2. 

• Dual boot is not supported. 

• Easy Path installation. 

• Mobile File Sync. 

• PCOMM Lite 4.1. 

• Keyworks. 
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• Remote client installation is not supported. 

1.6 Server packaging and licensing 

As of this writing, OS/2 Warp Server for e-business is comprised of eight 
CD-ROMs. In addition to the CD-ROMs described below, the product ships 
with a bootable CD and a Quick Beginnings hard copy manual for the specific 
language version purchased. This section describes the contents of each 
CD-ROM. 

CD-ROM #1 This is the bootable CD. Should your BIOS not support boot 
from CD-ROM, you can still create and use the diskettes to 
boot. 

CD-ROM#2 This contains the server code including the OS/2 base, the 
uniprocessor and symmetric multiprocessor kernels, OS/2 
LAN Server functions, MPTS, TCP/IP, Remote Access 
Services, Backup and Recovery Services, Tivoli 
Management Agent, Java Version 1.1.7, Netscape 
Communicator, and online documentation. This CD-ROM 
comes in the specific language version that was purchased. 

CD-ROM #3-5 This contains the Client Connect Pak. This is the client 
function for OS/2 Warp 4, Windows 95/98, Windows NT 
Version 4 and Windows 3.1. The functions included (not 
necessarily for all platforms) are File and Print, TCP/IP, 
Remote Access, Tivoli Management Agent, and Java 
Runtime. These functions are provided in all supported 
languages. 

CD-ROM #6 This contains the Netfinity Version 5.2 component. This 
function is provided in the specific language version that 
was purchased. 

CD-ROM #7 This contains the Lotus Domino Go Web Server Version 
4.6.2 and the IBM WebSphere Application Server Version 
1.1. This CD-ROM is provided in the specific language 
version that was purchased. 

CD-ROM #8 This is the security CD and contains either 56 bit or 128 bit 
encryption for use within the USA. This CD-ROM is 
separately purchasable. 

1.6.1 386 HPFS licensing 

386 HPFS is available as a separate product. For customers who currently 
have OS/2 Warp Server advanced, this is a no-charge upgrade. For 
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customers who have made a new purchase of OS/2 Warp Server for 
e-business or customers who previously had OS/2 Warp Server Entry and 
wish to use 386 HPFS, it will need to be purchased separately. 



1.7 The installation process 

OS/2 Warp Server for e-business and the many optional components can be 
installed using either an attended or an unattended installation procedure. If 
you are installing just a few servers, you will probably choose to use the 
attended installation process. This is covered in great detail in the online 
documentation, Quick Beginnings: Installing OS/2 Warp Server for 
e-business, and will not be covered here. 

In each of the chapters that follow, a description of the installation of that 
particular component may be included. 

Sample response files are also provided with the product and the optional 
components for unattended installation. 

Two significant changes from the previous version are: 

• The easy installation path has been removed. The new attended 
installation takes you through what was previously the advanced install 
path. 

• The product now ships with a bootable CD, which can be used in place of 
the two or three boot diskettes that came with OS/2 Warp 4.0 and OS/2 
Warp Server. 

1.7.1 The bootable CD 

OS/2 Warp Server now ships with a bootable CD. This speeds up the boot 
and install processes. The CD, however, may not work for some systems. 

This may be for one of the following reasons: 

• Some older hardware does not support boot from CD-ROM. 

• The CD contains support for a limited number of devices. If the controller 
to which either your Hard File or CD-ROM drive is attached is not 
recognized, you will need to create diskettes. 

These diskettes can then be modified to add the necessary device drivers. 
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Chapter 2. Base operating system enhancements 



The base operating system for OS/2 Warp Server for e-business is an 
advanced multitasking, 32-bit operating system that runs DOS, Windows, and 
OS/2 16 and 32 bit applications and utilizes SMP hardware configurations. 
OS/2 Warp Server version 4.0 was based on the OS/2 Warp Connect 
operating system. OS/2 Warp Server for e-business is based on a modified 
OS/2 Warp 4.0 operating platform. 

Many of the components that operate on upper layers make use of the 
essential services provided by the base operating system. Many changes 
have been made to make OS/2 Warp Server for e-business a premier 
operating platform. Some changes are discussed here, and others are 
covered in the chapters that follow together with the service that they 
enhance. 

Many new features and enhancements have been incorporated into this 
version of the OS/2 base operating system. All of the service elements that 
have been changed since OS/2 Warp 4.0 was released as well as those 
incorporated into OS/2 Warp Server and OS/2 Warp Server SMP have been 
integrated into this version of the base operating system. 

In this chapter, we will give a brief introduction to the new l 2 0 driver model, 
talk about the SMP enhancements, provide information about the large file 
support, and the 1024 cylinder boot restriction. We will also discuss the new 
version of Netscape, Java 1.1.7, the global locale builder, and Euro support. 



2.1 Virtual memory support 

The virtual memory map of the system has been changed, which may allow 
up to an additional 32MB of virtual memory. This OS/2 High Memory area 
support, introduced in OS/2 Warp Server SMP, is enhanced in this release 
and available on both the uniprocessor and SMP versions of the operating 
system and allows pure 32-bit OS/2 applications the potential to address up 
to 3GB of virtual memory. 



2.2 Intelligent input and output l 2 0 

OS/2 Warp Server for e-business provides support for Intelligent Input/Output 
(l 2 0) based LAN and SCSI adapters. I 2 0 is a specification that defines a 
standard architecture for intelligent I/O that is independent of the specific 
device and host operating system. It defines an approach where the interrupt 
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processing tasks are off-loaded from CPU to I/O processors designed 
specifically to handle I/O, thus, relieving the CPU of I/O tasks. I 2 0 makes it 
easier for developers to implement cross-platform intelligent I/O solutions. 

2.2.1 l 2 0 architecture 

In a networking environment, a significant amount of CPU time is used to 
perform I/O tasks. A significant amount of time, money and effort is also spent 
on developing device drivers on multiple platforms for hardware devices 
manufactured by different hardware vendors. The l 2 0 specification is an 
attempt to standardize the device driver development to make it easier to 
develop cross-platform intelligent I/O solutions. 

Intelligent Input/Output (l 2 0) is a specification that provides an open 
architecture for the development of device drivers for intelligent I/O. It is 
independent of the operating system and attempts to standardize the driver 
development by transferring the interrupt-intensive tasks from the CPU to I/O 
processors (lOPs). The lOPs are designed specifically to handle I/O 
transactions. The l 2 0 specification is intended to provide a standard 
approach to driver development that makes it easier for the developer to write 
a device driver for a class of adapters (like LAN disk adapters). 

Off-loading the interrupt-intensive tasks from the CPU to the lOPs is achieved 
by implementing a split driver model. According to the l 2 0 specification, this 
split driver model consists of two parts: The first part interfaces with the host 
OS, and the second part resides and interfaces with the adapter. The two 
parts communicate through a communications layer. The first part is known 
as the Operating System Service Module (OSM) and the second part is 
known as the Hardware Device Module (HDM). The OSM and the HDM 
communicate through the communication system. This communication 
system consists of two layers. The Message layer, which sets up the 
communication and a Transport layer, which defines how information will be 
exchanged. 
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Figure 7. I 2 0 architecture. 



2. 2. 1.1 Operating System Service Module 

The OSM is the part of the driver that sits on the operating system and 
interfaces with the operating system. The OSM interfaces with the l 2 0 
communication layer on the lower end. The requests from the OS are 
translated by OSM into messages and are sent to the HDM through the 
message layer. The HDM communicates the results back to the OSM through 
the message layer. The OSM then translates these messages and passes 
them to the operating system. The OSM is the interface between the 
operating system and the device. Operating system vendors develop OSMs. 
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2. 2. 1.2 Hardware Device Module 

The Hardware Device Module (HDM) which resides on the adapter is the 
device-specific portion of the driver. It interacts with the OSM through the 
Message layer. HDMs receive I/O requests in the form of messages from the 
OSM through the Message layer. The HDM processes the request and 
communicates the results back to OSM using the Message layer. The HDMs 
are developed by the hardware device vendor. 

2. 2. 1.3 Communications system 

The communication system of the l 2 0 consists of two layers. 

1. Transport layer: 

It defines how the OSM and HDM exchange information 

2. Message layer: 

It sets up the communication between OSM and HDM. The Message layer 
is the backbone for l 2 0. It handles all the communication that takes place 
between OSM and HDM. It handles the receiving and dispatching of 
messages and provides service routines for processing the messages. 
The messages consist of two parts: A header and a payload. The header 
consists of the type of service and the return address of the requestor. 
There are three components in the message layer: 

1. Message handle 

2. Message queue 

3. Message Service Routine 

When a request is made, a message is deposited in the message queue and 
a message service routine is activated to process the request. A message 
handle, which is the address of the service routine, is returned to the 
requester. 
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2. 2. 1.4 l 2 0 LAN OSM implementation 

The LAN l 2 0 OS Service Module (OSM) supports network adapters attached 
to the OS/2 system via 120 as specified in the Intelligent I/O Architecture 
Specification dated November 1996, Draft Revision 1.5a adopted by the SIG 
Membership March 21,1997. 

The specific implementation for OS/2 is as a Network MAC driver conforming 
to the 3COM/Microsoft LAN Manager Network Driver Interface Specification 
(NDIS) version 2.0.1. It utilizes the operating system message services 
developed for the l 2 0 storage and SCSI peripheral (l 2 OEXPORT.SYS). 

The l 2 0 architecture specifies a split driver module that allows the operating 
system vendor to develop an Operating System Service Module(OSM). 




Figure 8. Flow of information with an l 2 0 adapter. 

The normal flow of information from TCP/IP utilizing Protman remains in 
effect with the addition of the ability of Protman to recognize the OSM as a 
MAC driver. 
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The LAN OSM will communicate with the rest of the OS using the NDIS 2.0.1 
Interface and will communicate with the HDM using the LAN l 2 0 interface 
through the Message Handler. 

The l 2 0 LAN OSM utilizes the message handler developed for l 2 0 SCSI 
(I20XP0RT.SYS) and the I20CALLS (I20CALLS.LIB) developed for that 
subsystem. At system boot time, I20XP0RT.SYS detects lOPs on the system 
and initializes each IOP accordingly. The LAN OSM loads after 
I20XP0RT.SYS and calls it to find out each lOP's ID. The LAN OSM then 
calls each IOP to find out its configuration and registers with the kernel; so, it 
can send I/O Request Blocks. The LAN OSM allocates memory to contain the 
formatted l 2 0 message. The l 2 0 message handler copies the l 2 0 message to 
shared memory (shared between the processor and the IOP). 

2. 2. 1.5 Hardware support 

The l 2 0 LAN OSM(s) and Message Handler requires an l 2 0 LAN Adapter. 
This is a LAN adapter with an Intelligent I/O processor on the adapter which 
will host Hardware Device Module(HDM) software which will interface to the 
LAN OSM(s) via the Message Handler. 

In general, four adapters per server is considered the maximum number 
supported. This is for practical reasons of system capability with reasonable 
performance, however, there is no actual system constraint which prohibits 
more than four. 

2. 2. 1.6 Error logging 

If the LAN SOM fails to load at boot time, it will log a message at boot time; it 
will log a message to the screen during processing of CONFIG.SYS, and the 
user must hit ENTER to continue. 

The LAN OSM does not log messages to lantran.log; however if a protocol 
fails to bind with the l 2 0 LAN adapter, the protocol will log an error message 
to lantran.log. 

2. 2. 1.7 Installation and configuration issues 

Installation of the LAN l 2 0 OSM is the same as for any other LAN driver. In 
our example, we added a pre-production Soliton EtherPUMP adapter into a 
Netfinity 5500 server. To activate the adapter, we did the following: 

1 . Start MPTS by typing mpts at an OS/2 command prompt and pressing 

Enter. 

2. Select the configure button, and you will get the panel displayed in Figure 
9 on page 29. 
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Adapter and Protocol Configuration 



Select a network adapter and then select protocols to go with it. 
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Figure 9. Adapter and protocol configuration, selecting the l 2 0 LAN driver. 

3. In the Network Adapters window in the top left corner, select the IBM 120 
LAN Driver; then, click on the Add button. 

4. This will add it to the current configuration window in the bottom left corner 
of the panel. Select the adapter in the current configuration window and, 
then, select a Protocol from the top right window in the panel. 

5. Select Add to add the protocol to the adapter. In the example, we added 
the NetBIOS protocol to the adapter. The configuration is shown in Figure 
10 on page 30 
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Adapter and Protocol Configuration 



Select a network adapter and then select protocols to go with it. 
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To edit driver parameters, select an item below 
and then select Edit. 
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Figure 10. Adapter and protocol, l 2 0 configuration 

6. Select OK to commit the configuration. A confirmation window appears 
allowing you to select which CONFIG.SYS files you wish to update. Note 
that if you have multiple partitions that have multiple installed copies, they 
will all be listed here if they are visible to this partition. Decide carefully if 
you do not want to unnecessarily update other partitions. 
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Update CONFIG.SYS 



Select the drives on which CONFIG.SYS will be updated. 

Select Exit to update CONFIG.SYS with the changes you 
have made. A backup copy of each CONFIG.SYS file will be 
saved as CONFIG.MPT. 



S' Update CONFIG.SYS 



Drives to update 





Cancel 



Help 



Figure 11. Adapter and protocol configuration, CONFIG.SYS update 

7. Select Exit to finally update the configuration. You will need to reboot the 
machine to have the drivers take effect. 



—IBM Lock File Device Driver 

MPTS configuration makes use of the lock file device driver. Files that 
need to be replaced and are loaded at system initialization time are 
replaced using the lock file device driver. 

If, at any time after rebooting, you are unable to re-enter the MPTS 
configuration, remark out or delete the lock file device driver from your 
CONFIG.SYS and rename or delete the file 
x:\OS2\INSTALL\IBMLANLK.LST. 



8. By adding the adapter, both your CONFIG.SYS and PROTOCOL.INI file 
have been changed. The LANTRAN.LOG file contains a listing for the LAN 
initialization. The LANTRAN.LOG reported the following after installing the 
l 2 0 adapter: 

LT00073 : FFST/2 is installed but is not started. LANTRAN.LOG is being created. 

IBM OS/2 LANMSGDD [04/07/99] 5.05 is loaded and operational. 

IBM OS/2 NETBEUI 5.50.0 

NETBEUI: Using a 32-bit data segment. 

IBM OS/2 TCPBEUI 5.50.0 
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TCPBEUI : Using a 32 -bit data segment. 

Installing NETWKSTA .200 Version 6.0. IBM LAN Redirector ( Apr 12, 1999) 

IBM OS/2 NETBIOS 4.0 

Adapter 0 has 30 NCBs, 152 sessions, and 27 names available to NETBIOS applications. 
Adapter 1 has 123 NCBs, 28 sessions, and 6 names available to NETBIOS applications. 
Adapter 2 has 252 NCBs, 254 sessions, and 41 names available to NETBIOS applications. 
NETBIOS 4.0 is loaded and operational. 

IBM OS/2 Warp 3.0 and above NDIS 2.0 IBM Token-Ring PCI Family Adapter, Version 2.00 
IBM OS/2 LAN Netbind 

Port 00000000: The IBM Token-Ring PCI Family Adapter UAA (BIA) is 00203503cb33 . 

Port 00000000: The IBM Token-Ring PCI Family Adapter opened at 16 Mbps, half duplex. 
TCPBEUI: completed initialization and is bound to TCP/IP network interface lanO. 
Adapter 0 is using node address 00203503CB33 . 



Adapter 2, in the above listing, is the 120 adapter. 



2.3 1 024 cylinder restriction 

When the operating system or an application wants to access a hard disk in 
real-address mode, it normally does it via the BIOS (BASIC Input/Output 
System) via the INT 13h services. The BIOS provides a standard interface to 
the hard disk. This INT 13h interface allows the operating system and 
applications to access the hard disk without the need for the applications to 
understand the complexities of accessing the hard disk. However, the 
standard INT 13h interface does not allow the operating system to boot from 
any point on the hard disk and limits the capacity that can be addressed to 
8.4GB. 

OS/2 Warp Server for e-business overcomes this limitation. Thereby, allowing 
you to install and boot the operating software on any point on the hard drive 
and recognizing drives that are greater than 8.4GB in capacity. 

2.3.1 The INT 13h interface 

To understand the 1024 Cylinder restriction, it is important to know how the 
data is accessed on the hard disk drives. To read data from the hard disk 
drives, the location of the data on the disk platters has to be specified. The 
location on the disk is expressed in terms of drive geometry. The geometry of 
the drive is normally expressed in terms of the cylinder, head, and sector that 
the system wants the drive to read. A request is sent to the drive over the disk 
drive interface giving it this address and asking for the sector to be read. The 
geometry of the drive is specified using the INT 13h interface. 

The INT 13h supports many different commands, such as disk read, write, 
and so on, that are then submitted by the BIOS to the hard disk directly. 
When a command is passed on to the hard disk, the head, cylinder, and 
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sector number have to be provided. The head, cylinder, and sector 
addressing is called drive geometry. The drive geometry is passed on in 
registers, and INT 13h provides 24 bits to specify the drive geometry. The 24 
bits are broken as follows: 

1 0 bits for the cylinder number (Maximum of 1 024) 

8 bits for the head number (Maximum of 256 heads) 

6 bits for the sector number (Maximum of 63 sectors; sectors are numbered 
from 1 , not 0) 

The sector size is a standard 512 bytes. 

The default mode used for disk access is the CHS mode. CHS stands for 
Cylinder, Head, Sector. This interface, therefore, restricts the number of 
sectors (per track) to 63, the number of heads to 256, and the number of 
cylinders to 1024 for a total of 8.4 gigabytes (63*256*1 024*51 2=8. 4GB). 

But, the hardware specification of the ATA drives (IDE drives), limits the 
number of sectors/tracks to 255, heads to 16, and cylinders to 65536. This 
limits the device to 136.9 GB (255 * 16 * 65536 * 512 =136.9 GB). If a drive is 
to be accessed through BIOS, the smaller value must be used as the limit. 16 
heads supported by ATA drives is a smaller value. Considering this, the 
access is now restricted to 528 MB (63 * 16 * 1024 * 512 = 528 MB). 



Table 2. Limitations of various interfaces 





BIOS 


ATA 


Limit 


Max Sec- 
tors/Track 


63 


255 


63 


Max Heads 


256 


16 


16 


Max Cylinders 


1024 


65,536 


1024 


Capacity 


8.4 GB 


136.9 GB 


528 MB 



The above limitations can be overcome in two ways: 

1 . Create a false geometry that fits within the Int 1 3h limitations and also 
uses the full capacity of the drive. This is called drive translation. There is 
a problem with drive translation. Since there is no single standard for drive 
translation, several independent translation method exists. If a drive is 
moved from one computer to a different computer, the data on the drive 
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will not be recognized unless both computers use the same translation 
algorithm. 

2. Address the drive using the enhanced INT 13h extensions. The enhanced 
INT 13h interface, in addition to overcoming the 528MB limit, also 
overcomes the 8.4 GB limitation problem faced when a conventional INT 
13h interface is used. 

The new enhanced INT 13h services are fundamentally different from the 
existing INT 13h services in the following ways: 

• They support the passing of data structures and are not register based 

• Buffers are used to pass on the media address information 

• Flags are used to identify optional capabilities 

2.3.2 OS/2 boot process 

The OS/2 boot process within OS/2 Warp Server for e-business now uses the 
enhanced INT 13h services to access the hard disk. With the 1024 cylinder 
limitation, the user was restricted to boot from partitions that were contained 
within the first 1024 cylinders. This limitation has now been removed. This 
section explains the boot process that gives an idea about where all the INT 
13h service is employed during the boot process: 

The OS/2 boot process uses the INT 13h services to access the hard disk 
before all of the base device drivers are loaded. 

2. 3. 2.1 FAT and HPFS boot flow 

The first six steps are common to both FAT and FIPFS boot because they are 
file system independent flow. 

2. 3. 2.2 FAT boot flow 

The following figure illustrates the FAT boot flow: 
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Figure 12. FAT boot process 

The steps involved in the FAT boot process are listed below: 

1 . System BIOS issues a request via BIOS INT 1 3h services to the hard disk 
to read the Master Boot Record (MBR). 

2. The MBR is loaded into the memory. The MBR inspects the partition table 
to determine whether Boot Manager or an active bootable partition should 
be loaded. 

3. The MBR issues a request to the hard disk via the INT 13h services to 
read the boot sector for the selected partition into memory. 

4. If the selected partition was Boot Manager, the Boot Manager boot sector 
is loaded into memory. 

5. If the selected partition was Boot Manager, Boot Manager will determine 
which partition should be booted and will issue a request to a hard disk via 
BIOS INT 13h services to read the boot sector for the bootable partition 
into memory. 

6. The boot partition for the bootable partition is loaded into memory. 

7. The FAT Boot sector determines the location of OS2BOOT and issues a 
request to the hard disk via BIOS Int 13h services to read OS2BOOT into 
memory. 

8. OS2BOOT is loaded into memory and determines the location of 
OS2LDR. 
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9. 0S2B00T issues a request to the hard disk via BIOS INT 1 3h services to 
read OS2KRNL into memory. 

1 0.OS2LDR is loaded into memory and determines the location of OS2KRNL. 

1 1 .OS2LDR issues requests to the hard disk via BIOS INT 13h services to 
read OS2KRNL into memory. 

12.0S2KRNL is loaded into memory. 

13.0S2KRNL issues requests to OS2LDR to read various BASEDEVs into 
memory. 

14.0S2LDR issues requests to the hard disk via BIOS INT 13h services to 
read various BASEDEVs into memory. 

15. BASEDEVs are loaded into memory. 

16. After all BASEDEVs have been loaded and initialized, any further read 
requests are issued to the BASEDEVs. 

17. The BASEDEVs issue read requests to the hard disk via direct hardware 
access. 

18. The requested information is loaded into memory. 

2. 3. 2.3 HPFS boot flow 

The following figure illustrates HPFS boot flow: 




Figure 13. HPFS boot process 

The steps involved in the HPFS boot process are listed below: 
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1 . System BIOS issues a request to the hard disk via BIOS INT 1 3h services 
to read the Master Boot Record (MBR). 

2. The MBR is loaded into the memory. The MBR inspects the partition table 
to determine whether Boot Manager or an active bootable partition should 
be loaded. 

3. The MBR issues a request to the hard disk via INT 13h services to read 
the boot sector for the selected partition into memory. 

4. If the selected partition was Boot Manager, the Boot Manager boot sector 
is loaded into memory. 

5. If the selected partition was Boot Manager, Boot Manager will determine 
which partition should be booted and will issue a request to a hard disk via 
BIOS INT 13h services to read the boot sector for the bootable partition 
into memory. 

6. The boot partition for the bootable partition is loaded into memory. 

7. The HPFS Boot sector determines the location of the HPFS micro-FSD 
and issues a request to the hard disk via BIOS INT 13h services to read 
the HPFS micro-FSD into memory. 

8. The HPFS micro-FSD is loaded into memory and determines the location 
of OS2LDR. 

9. The HPFS micro-FSD issues a request to the hard disk via BIOS INT 13h 
services to read OS2LDR into memory. 

10.OS2LDR is loaded into memory. 

11.0S2LDR issues a request to the HPFS micro-FSD to read OS2KRNL into 
memory. 

12. The HPFS micro-FSD determines the location of the OS2KRNL and 
issues a request to the hard disk via the INT 13h services to read 
OS2KRNL into memory. 

13.0S2KRNL is loaded into memory. 

14.0S2KRNL issues a request to HPFS micro-FSD to read BASEDEVs into 
memory. 

15. The HPFS micro-FSD issues requests to the hard disk via the INT 13h 
services to read various BASEDEVs and the HPFS mini-FSD into memory. 

16. BASEDEVs and HPFS mini-FSD are loaded into memory. 

17. After all BASEDEVs and HPFS mini-FSD are loaded and initialized, read 
requests are issued to the HPFS mini-FSD to load additional system 
components, including HPFS.IFS, into memory. 

18. The HPFS mini-FSD determines the location of these components and 
issues read requests to the BASEDEVs. 

19. The BASEDEVs issue read requests to the hard disk through direct 
hardware access. 
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20. The additional system components and HPFS.IFS are loaded into 
memory. 

21 .After HPFS.IFS is loaded and initialized, any further read requests will 
come from OS2KRNL to HPFS.IFS 

22. HPFS.IFS issues a read request to the BASEDEVs. 

23. The BASEDEVs issue read requests to the hard disks through direct 
hardware access. 

24. The requested information is loaded into memory. 

FDISK currently prohibits a user from setting a partition as installable or 
startable if it is not wholly contained within the first 1024 cylinders. LVM will 
allow installable and startable partitions of up to 1024 cylinders unless the 
BIOS supports large hardfiles. If BIOS supports large hardfiles, a partition in 
any location may be set installable or startable and added to the Boot 
Manager menu. 

2. 3. 2. 4 Dependencies 

In order for this support to be activated, the machine BIOS must support the 
Enhanced INT 13h interface. Also, the BIOS must support drives with more 
than 1024 cylinders (capacity greater than 8.4 GB) if this support is to be 
activated above 1024 cylinders. 



2.4 Kernel enhancements and file subsystems 

This section describes enhancements that have been made to kernel and file 
subsystem environment. Changes have been made to the Installable File 
System Manager (IFSM) and the Kernel Execution Environment(KEE) in 
OS/2 Warp Server for e-business to improve the performance and SMP 
scalability of the file system (JFS/LVM/OS2DASD) and the communications 
stack (TCP/IP). 

An installable File System (IFS) is a dynamically loadable module. It is loaded 
by using a CONFIG.SYS command, IFS=.... HPFS, HPFS386, and JFS are 
examples of an IFS. The IFS handles all file system requests for its file 
system. The IFS is also referred to as a File System Driver (FSD). The 
Installable File System Mechanism (IFSM) defines the relationship between 
an IFS and the OS/2 kernel File System Router. The File System Router is 
responsible for routing file system requests to the appropriate entry point in 
the IFS. 

The Kernel Execution Environment is a set of new, 32-bit, SMP-enabled, 
subsystem API’s. 
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The performance enhancement is achieved by converting part of the existing 
kernel execution environment from 16 bit to 32 bit. 

Poor SMP scaling is also due to the fact that the OS/2 kernel must provide 
serialization for the legacy device drivers on SMP since they are not SMP 
enabled. The OS/2 SMP kernel provides the serialization that protects the 
device driver's data structures from data corruption (concurrent access by 
multiple threads on SMP) by using a single system-wide spinlock. This spin 
lock is known as the SUBSYS spin lock. The SUBSYS spinlock is acquired by 
the kernel on behalf of the device driver every time the kernel calls into the 
device driver. Because a single spin lock is employed, only one processor 
can be executing code in a device driver at any one point in time. This leads 
to poor SMP scaling when there are multiple threads needing to execute in 
the device driver. The other threads must wait (spin) until the owning 
processor releases ownership of the SUBSYS spin lock. 

To correct the scaling problem, the device drivers will use the new 32-bit 
SMP-enabled Kernel Execution Environment (KEE). KEE is a set of 32-bit 
SMP-enabled APIs. KEE provides a set of system service APIs that will 
enable data structures with more granular spin locks instead of using the 
system-wide SUBSYS spin lock. This improves the SMP scalability. In 
addition, the KEE APIs require fewer CPU cycles than the 16-bit device 
helper APIs; so, performance improves on both UNI and SMP. 

Some disadvantages of a 16-bit code path are: 

• 16 bit code runs slower than 32 bit code. 

• The file system router is a 16-bit router that limits the size of a DosRead 
and DosWrite to a value less than 64K. Therefore, an application request 
larger than 64K is broken into multiple calls to the IFS. 

• The OS/2 SMP kernel will serialize the execution of all code in an 
installable file system (HPFS) and device driver (OS2DASD, *.ADD) using 
a single system-wide spinlock (SUBSYS spinlock). In the 16-bit code path, 
this spin lock is held over most of the code path and results in poor SMP 
scalability. 

• The kernel stack selector is 16-bit. Therefore, overhead is incurred when 
an address of a local variable is required to be passed to a function. 

• The system services, device helper, and file system helper are 16-bit. The 
device helper services use a router mechanism. The overhead of the 
device help router is significant. 

The new 32-bit code path provides the following improvements: 

• Portions of the kernel File System Router layer, JFS, LVM, and OS2DASD 
(10 path) are 32-bit resulting in improved execution time. 
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• Portions of the File System Router are 32-bit; there is no limit on the 64K 
size for an I/O call like DosRead or DosWrite. 

• The kernel File System Router will not acquire the SUBSYS spinlock prior 
to calling the 32-bit JFS entry points for DosRead, DosWrite, and 
DosChgFilePtr. JFS/LVM/OS2DASD use the new KEE spinlock APIs to 
provide more granular locking of its data structures resulting in improved 
SMP scalability. The SUBSYS spinlock will be acquired prior to calling the 
SCSI ADD and represents only a small percentage of the total I/O path. 

• The system services (KEE calls) are 32-bit and do not use a router. The 
code path for a call is significantly reduced. 



2.5 SMP support and microprocessor affinity 

Previously, SMP support was provided in a separate OS/2 Warp Server 
Advanced feature. Now, support for up to 64 processors is included in one 
package. The OS/2 Warp kernel in OS/2 Warp Server for e-business as well 
as the file systems have been further tuned to improve processing scalability. 

Since OS/2 Warp Server for e-business comes with both a kernel for 
machines with one processor and an SMP enhanced Version, you now have 
the option to start on a Server with only one processor installed. If your 
requirements outgrow this, you can add the SMP Support later using 
selective install. A multiprocessor system must either comply with the Intel 
Multiprocessor Specification, Version 1 .4 or 1 .1 , or it must be one of the 
following computers, each of which has its own proprietary SMP architecture: 

• Compaq Proliant 2000 

• Tricord PowerServer, models 30 and 40 

• IBM PC Server 720 

During installation, you will be allowed to select Multiprocessor Support. This 
is shown in Figure 14 on page 41. 
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|®jp OS/2 Warp Server for e-business Setup and Installation 



Options Software configuration Help 



Make sure there is a check in the box next to the features you wish to install. Select 
"More..." to make additional choices for a feature. 



□ Assistance Center (1.74MB) 

□ Fonts (207.08MB) 

□ System Utilities (2.29MB) 

□ System Components (1.07MB) 

□ Printer Utilities (10.79MB) 

□ Tools and Games (18.31MB) 

□ OS/2 DOS Support (1.64MB) 

□ WIN- OS/2 Support (9.17MB) 

□ Multimedia Software Support (18.36MB) 

□ Java Development (25.28MB) 

SS Symmetric Multiprocessor Support (1.01MB) 



Previous 




Next 

















Figure 14. OS/2 Warp Server, selective install, SMP support 
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If you do not meet the requirements above, your hardware manufacturer 
might have written its own *.PSD driver file to support OS/2 Warp Server for 
e-business SMP on his hardware. In this case, when you select SMP Support 
as shown in Figure 14 on page 41, you will need to provide the location of a 
valid PSD file. It would be best to check this in advance whether such support 
is available. 



Some applications running on Multi-Processor systems require the capability 
of designating which processor or group of processors a thread is eligible to 
run on. This designation is called processor affinity. There are two new OS/2 
kernel APIs which allow OS/2 applications to specify Processor Affinity in a 
multiprocessor environment. These APIs are 

1. DosSetThreadAffinity () 

2. DosQueryThreadAffinity() 

These APIs will have no effect on UNI Processor environment. 
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Support for OS/2 processor affinity is controlled by two new kernel data fields: 

qwCapableAffinity - This is the mask of processors available to OS/2 in the 
system; it is new to the kernel's global data. 

qwThreadAffinity - This is the mask of processors available to the thread; it is 
new to each thread's internal data. 

The processor affinity mask fields are 64bit wide fields and use 1 bit to 
represent each processor in the system. This support is therefore limited to 
multiprocessor systems with 64 or fewer processors. If an affinity mask bit is 
set, the OS/2 scheduler will make the thread eligible to be run on the 
corresponding processor(s). If the affinity mask bit is not set, the scheduler 
will never run the thread on the corresponding processor(s). Non-existent 
processors will always be represented by reset bits in any affinity mask. 

The system initializes the qwCapableAffinity mask with one bit set on for each 
processor available to OS/2. The bits will be set contiguously starting with bit 
zero. 

The kernel maintains each thread's current affinity, qwThreadAffinity, in the 
Thread Control Block (TCB.) Any attempt to change a thread's 
qwCurrentAffinity (via DosSetThreadAffinityj must be attempting to redefine 
Processor Affinity as a subset of qwCapableAffinity. Any attempt to set an 
affinity mask to zero will be rejected. 

All new thread created will inherit the current thread's qwThreadAffinity mask. 
The new thread will then be capable of setting its current affinity, via 
DosSetThreadAffinity, to any subset of the system's qwCapableAffinity mask. 

Application developers may use Processor Affinity APIs to force a thread's 
execution to one or more specific processors. This is useful for collecting 
diagnostic information from a specific processor. Secondarily, the ability to 
control which processor set an application runs on is useful as a performance 
tuning mechanism. 



2.6 Large file support 

Today’s data storage requirements have exploded with new data types, such 
as video and the need to house large databases. Currently, OS/2 APIs and 
filesystem structures use datastructures that impose a limit of 2 GB for file 
sizes. New APIs and data structures with 64 bit fields to hold file sizes/offsets 
have been added to overcome this restriction. For the rest of this section, 
Large File will refer to files that are greater than 2 GB in size. 
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JFS was designed with large files in mind; so, it already has 64 bit values 
internally. Changes have been made in the Installable File System Manager 
(IFSM) and the DOSCALLS interface to support large files. 

Since JFS is the only IFS that will support Large Files, the IFSM will hide this 
new support from FAT, HPFS, and FIPFS386 (and all other legacy 16bit IFSs, 
such as NFS, SRVIFS,...) and enforce the old 2GB limit to the same extent it 
does today even when an application uses the new APIs. 

Note 

Support for large files is NOT transparent to applications 



Support for large files is NOT transparent to applications. In order to create 
and use large files, applications have to be modified to take advantage of 
these new APIs. This support is limited to partitions using the JFS. 

A number of system utilities, such as XCOPY, are modified to take advantage 
of the new APIs and support Large Files. 

The Filesystem will handle access to Large Files in two ways. First, on a 
DosOpen, the new DosOpenL API will be used. If an application attempts to 
open a Large File using the old DosOpen, that application will be denied with 
a return code of ERROR_ACCESS_DENIED. The application will, therefore, 
not be able to read or write to the file. The second method of determining if an 
application is Large File Aware is on the data structures used. Applications 
which are Large File Aware should always use the new types even if they do 
not expect to use Large Files. 

The IFSM will handle some of the cross conversion between application and 
IFS. FS APIs have been modified to inform JFS as to when an application is 
not allowed to open Large Files. 

The rules for reading and writing Large Files are as follows. Applications 
using the new APIs on JFS will have complete access to all files at all times 
following the current access control. Applications using the old DosOpen will 
not be allowed to open files larger than 2GB. Applications using the old APIs 
(specifically the DosOpen API) will be allowed normal access to files less 
than 2GB in size regardless of whether or not the file is opened by a process 
using the new DosOpenL. In order to prevent legacy applications from taking 
an unexpected error in the middle of processing a file, a limitation is placed 
on the new API. The limitation is that a file may not be grown past the 2GB 
limit while a legacy open is in progress. If this condition occurs, a sharing 
violation error will be returned to the application. Since this error can only 
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occur if the file is opened by multiple applications, the new application can 
prevent this by opening with the OPEN_SHARE_DENYREADWRITE mode 
flag. If the application requires shared access to a file, a new sharing flag 
OPEN_SHARE_DENYLEGACY may be specified. This flag is used in 
addition to the other sharing flags and only affects opens through the legacy 
DosOpen. It has no effect on DosOpenL calls. Setting this flag on an open will 
have the same effect on legacy applications as 

OPEN_SHARE_DENYREADWRITE. This means that the only error relative 
to large file that a legacy application should see is an 
ERROR_ACCESS_DENIED on a DosOpen. 

Applications that are required to work on versions of OS/2 prior to OS/2 Warp 
Server for e-business should not issue the new APIs directly. They should use 
DosQueryProcAddr to determine if the new API exists, and, if not, issue the 
old API. For the APIs that use new infolevels but do not have a new API 
name, the application should issue the command with the new Infolevel, and, 
if an ERROR_INVAID_PARAMETER is received, the application should then 
reissue the command using the old Infolevel. 

All old APIs and data structures will continue to be supported; so, all current 
applications will continue to work with the one exception that they will not be 
able to see or open files greater than 2GB in size that have been created by 
new applications. 

2.6.1 SES and large file support 

There are new SES KPIs for use with large files within JFS volumes. Third 
party security products implement Installable Security Subsystems (ISS) that 
make use of SES APIs. These vendors and/or customers will need to modify 
their Installable Security Subsystems to be aware of large files. 

Existing ISSs using the old SES API may prohibit access to data in large files 
(beyond 2GB). This may cause the system to halt or hang because the ISS 
does not know how to deal with large files. It is not possible to determine the 
exact behavior of an ISS using the old SES API on a JFS file that grows 
beyond 2GB. 
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Note 



Running an ISS implemented with the old SES API on a JFS file that 
grows beyond 2GB is not supported. This can result in data loss, a 
system crash, or some other unpredictable behavior. 

A customer should not use an old API ISS with large files. A customer 
should get an upgraded ISS from their ISS vendor that has been developed 
and tested to support large files. 

SES support in OS/2 Warp Server for e-business only provides the ISS 
vendors with an API extension to support large files. It is the ISS vendor's 
responsibility to implement that API. 



Tests indicate that legacy ISSs on OS/2 Warp Server for e-business with JFS 
files smaller than 2GB are acceptable. But, as soon as a file on JFS grows to 
more than 2GB in size running a legacy ISS, there could be a system failure. 



2.7 Java 1.1 



The OS/2 Warp family has consistently provided highly-competitive Java 
performance. The latest OS/2 Java implementation (Java 1.1.7 based) 
provides state-of-the-art Java performance integrated into OS/2. This 
provides customers the potential to combine high-capacity, high-performance 
web-serving, Java serving, and traditional network file and print serving, all 
using one platform. 

IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.7 (Developer 
Kit) is based on Sun Microsystems' Java 1.1. 7A maintenance level. 

This kit is also supported in the following environments: 

• OS/2 Warp 4 

• OS/2 Warp Server Version 4 

• OS/2 Warp Server Advanced Version 4 

• OS/2 Warp Server Advanced Version 4 SMP Feature 

• Workspace On-Demand clients and servers 

• OS/2 Warp 3 

• OS/2 Warp Connect 

Each of the above platforms may have individual fixpack requirements. 
Please check the online readme file for more information. OS/2 Warp Server 
automatically installs this component if it is selected. All prerequisite fixes are 
included in the package. 
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IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.7 replaces all 
previous versions of Java 1 .1.x for OS/2 Warp. If you do not uninstall the 
previous version, the installation program will replace it with the Developer 
Kit. If a previous version of a Java component was installed and you have not 
selected to reinstall that component, the installation program displays a 
window warning you that this component will be downlevel and then lets you 
choose to upgrade the component. 



2.8 Netscape 4.04 

Netscape 4.04 is available for installation. The version that is shipped is 
enabled to work with just 16 colors. 

Communicator builds on the existing Navigator 2.02 function, which is still 
supported. You can connect to the Internet and send e-mail worldwide, 
establish group communications with friends and colleagues, search for data, 
browse, view documents including those with video and audio, explore Virtual 
Reality Modeling Language (VRML) 3-D, and even publish on the World Wide 
Web. 

Some of the technical details that help enhance the new features include: 

• Dynamic HTML - technologies that transform static HTML pages into 
dynamic animated pages 

• JavaScript 1.2 - Dynamic HTML uses new functions of JavaScript: 

• Style Sheets - both Cascading Style Sheets (CSS) and 
JavaScript-accessible Style Sheets (JASS) 

• HTML layering and positioning tags - layer elements such as graphics 
and text that can be positioned and made visible or invisible under the 
control of JavaScript. 

• Autoinstall - Automatically download a plug-in when a page needs it. 

• Native OS/2 and Microsoft Windows 3.1 Plug-ins - Provided with the 
Communicator 4.04 for OS/2 Warp Plug-In Pack 

• MPEG - Support for MPEG movies 

• Invoke plug-ins using the Object tag in addition to the embed tag. 

• Dynamic Fonts - Send a font along with a document 

• Java 1.1.6- Support for the latest Java 1 .1 releases, including Java 1 .1.4 
for OS/2 and OS/2 Warp Developer's Toolkit for Java 1 .1 .6. 

• Security - Communicator added security features to help create a secure 
environment for conducting transactions over the Internet. Easing people’s 
security fears is essential to increasing business over the Internet. The 
new security features help make Communicator 4.04 a good choice to 
utilize the latest Web technologies in your transition to e-business. 
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Communicator 4.04 delivers: 

• A padlock icon that calls the Security Advisor. The details of your current 
connection's security status help you better determine what you can safely 
do or, perhaps, not do. 

• A 128 bit-strong encryption version for U.S. and Canada that uses strong 
cryptology to protect sensitive data is available separately. 

• Secure access controls when two or more people need to share the same 
computer. 

• PCMCIA-based security services. 

• Secure, encrypted, mail and news Certificates for additional identity 
verification. 



2.9 Graphical locale builder 

An e-business efficiently connects valuable information to the people who 
need it unecumbered by time zones and national borders. When customers, 
suppliers, or business partners are able to interact with Internet applications 
in their native language, more meaningful communications occur. 

OS/2 Warp Server for e-business transverses language barriers as it extends 
the existing l/T infrastructure to the internet. The IBM Graphical Locale 
Builder (GLB) help make business applications more intelligible to global 
customers and business partners who use different language, currency, and 
date formats. With the Graphical Locale Builder, companies can use a 
Graphical User Interface to quickly modify internationalization settings. 

A company can develop applications in their native language and then use 
any of the 14 languages supported by OS/2 Warp Server for e-business. 
From the Country Palette’s GUI interface, developers or administrators create 
a locale. Once locales are created for the various languages and countries, a 
user can drag a locale from the Country Palette and drop it onto applications 
that are fully enabled for international support. The international settings of 
that application then change to reflect the parameters of the locale. For 
example, a multinational bank can have its teller program running in German, 
and the language can be switched to French or even Japanese (double-byte 
character set) without having to reboot the system. An application that was 
originally set up for use in the U.S can be modified for use in France by using 
the GLB to change the currency to French Francs and the date to dd/mm/yy, 
even if the dates are in the year 2000 or beyond. 

The system locale defines a user environment. The locale specifies a 
language, currency, date format, and how the system handles formatting, 
conversions, sorts, and text processing procedures. 
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Applications will need to be written to take advantage of this feature. Here we 
will describe how to create a new locale and use it within some of the default 
applications. To create a new locale, you need to do the following: 

1 . Double click on the Locale icon within the OS/2 System Setup folder. This 
icon is shown in Figure 15 on page 48. 




2. This will bring up the Locale Folder. Select the Locale item of the action 
bar and then select new Locale to create a new Locale. This will bring up 
a dialog box as shown in the following figure: 




Figure 16. New locale name 

3. Enter a descriptive name for the new Locale. Select OK. This will bring up 
a settings notebook for your new Locale. The settings notebook is shown 
in Figure 17 on page 49. 
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Figure 1 7. Settings for new locale 

4. The settings notebook allows you to set all the variables that would be 
associated with that region. The application that is locale enabled will 
gather its settings from the values entered here. The first page allows you 
to set the base Locale from a drop down list. The syntax for base Locale is 
as follows: 

xx_yy 

Where xx represents the two-character ISO language identifier, and yy 
represents the two-character ISO country identifier. On this page, you can 
also select the Measurement to be Metric or English as well as the 
seperator. 

5. Use the help button for more information on each of the options. The other 
settings pages allow you to define the Numeric, Date, and other formats. 
When you are done, close the settings notebook and you will have a new 
Locale. Our new Locale called France is shown in Figure 18 on page 50. 
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Country Palette 




Figure 18. Two defined locales. 

To use the new locale, simply drag and drop the Locale icon onto the 
application that is Locale enabled. You can try this out by dropping the new 
icon onto the System Clock application within the System Setup folder or the 
OS/2 System Editor which is contained within the Utilities folder. You should 
notice language and date/time format changes. 

2.9.1 Java locale 

To create a Java Locale, you will need to have the JDK 1.1.7 or later installed. 
If this is not installed, you will get a cryptic error message. To create a 
corresponding Java Locale, simply: 

1 . Select the Locale icon you created earlier. 

2. Then select the Action item off the Menu. 

3. Then select Create Java Locale. 

2.9.2 Euro currency support 

Euro currency support is essential in some countries and industries today and 
will become more critical as the currency goes into circulation. Therefore, 
OS/2 Warp Server for e-business supports the euro currency character and 
enables using it in applications and Java applets. The euro is not supported 
in Win OS2. 

OS/2 support for the euro consists of adding euro character fonts, code 
pages, and keyboards. The following code pages are supported: 

• 850 PC Latin 1 

• 857 PC Turkish 

• 1004 Windows Extended 

• 1250 Windows Latin 2 

• 1251 Windows Cyrillic 

• 1252 Windows Latin 2 

• 1254 Windows Turkish 
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1257 Windows Baltic PM 



The euro character has been added to the following fonts: 

• Courier 

• Helv 

• Helvetica 

• System Monospace 

• System Proportional 

• System VIO 

• Times New Roman 

• Times New Roman MT 30 

• Tms Rmn 

• WarpSans 

The euro has been added to the following keyboards: 

Belgium, Germany Latin, Sweden, Swiss French, Canada, America, 
Germany, Swiss German, Canadian French, Netherlands, Iceland, Turkey, 
Denmark, Norway, Iceland 101, Turkey 440, Finland, Portugal, Italy, UK, 
France, Spain, Italy Extended, UK 168, US International. 
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Chapter 3. Adapters and protocol services 



OS/2 Warp Server for e-business provides you with a wide rage of supported 
networking protocols and communication adapters that you may use in many 
combinations to suit your requirements for a server system in a LAN 
environment as well as for wide-area networking. Adapters and protocol 
services may be called the communications engine of OS/2 Warp Server for 
e-business since it provides communication support for all the other 
components of this product. 

This chapter describes Adapters and protocol services and its component 
parts, new features in this release of OS/2 Warp Server for e-business, and 
some configuration examples. 

OS/2 Warp Server for e-business includes support for l 2 0 LAN Adapters. For 
more information on l 2 0 and setting up an l 2 0 LAN adapter, see Chapter 2.2, 
“Intelligent input and output l 2 0” on page 23. 



3.1 Overview of adapters and protocol services 

Adapters and protocol services can be divided into two parts: 

• LAN-Adapter and Protocol Support (LAPS) 

• Multiprotocol Transport Services (MPTS) 

3.1.1 Adapter and protocol support 

Originally, LAPS was called LAN Adapter and Protocol Support, but, since it 
also includes drivers for wide area networking adapters, we skipped the word 
LAN and kept the familiar acronym LAPS. LAPS includes the following 
networking protocols based on the Network Driver Interface Specifications 
(NDIS) standard: 

• IBM OS/2 NetBIOS 

• IBM TCP/IP 

• IBM IEEE 802.2 

• Netware NetBIOS Emulation over IPX 

This protocol ships with the Netware Requester for OS/2. LAPS simply 
provides an NDIS NIF file; so, a user who has installed the NetWare 
Requester (along with the NetWare NetBIOS protocol that comes with it) 
can configure it with LAPS. 

• IBM OS/2 NetBIOS over TCP/IP 
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• NetWare Requester support 

The files that make up LAPS and its configuration are placed under the 
\IBMCOM directory tree on the OS/2 boot drive. 




Figure 19. MPTS components 
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A wide range of LAN adapters for token-ring, Ethernet, and FDDI are included 
as well as WAN adapters and serial and parallel communications support for 
NDIS. A complete list of adapters supported by Adapters and protocol 
services can be found in the \IBMCOM\MACS\REDMAC.TXT file. 

3. 1.1.1 Network Driver Interface Specifications (NDIS) 

IBM transport strategy is based on the Network Driver Interface 
Specifications (NDIS) version 2.0.1- a standard jointly developed by 3COM 
and Microsoft Corporation. NDIS allows different network protocols to operate 
over the same LAN interface at the same time. 

NDIS is a standardized Medium Access Control (MAC) interface for network 
adapter and protocol drivers. It has become a de facto industry standard 
providing a common open interface that enables different manufacturers of 
network adapters and LAN software developers to produce products that 
communicate with each other. 

NDIS separates protocol handling from hardware manipulation by defining 
functions that protocol drivers and network adapter drivers must provide to 
each other. 

NDIS defines: 

• Specifications for network protocol drivers 

• Specifications for network adapter drivers 

• Interface between the above two layers 

• Binding process to link these protocol and adapter drivers 

A network protocol driver provides the communication between an application 
and a network adapter driver. 



Adapters and protocol services 55 




A network adapter driver or MAC driver provides the communication between 
a network adapter and a protocol. The main function of the network adapter 
driver is to support network packet reception and transmission. 

Each driver has an upper and a lower boundary. The drivers are linked 
together to form a stack by binding the lower boundary of one driver to the 
upper boundary of another driver. The MAC driver at the bottom of the stack 
always has its lower boundary connected to the physical layer - the network 
adapter hardware. 

The NDIS specification defines the binding process of the drivers. Three 
components are used to form and manage the protocol stack from individual 
drivers. These are: 

PROTOCOL.INI 

This is an ASCII file that defines the protocol drivers and adapter 
drivers in use and their binding information. 

PROTMAN.OS2 

This is a Protocol Manager. 

NETBIND.EXE 

This initiates the final binding process. 

The LAPS component of Adapter and Protocol Services contains the above 
three files, the protocol and adapter drivers, and a utility for easy installation 
and configuration of the required drivers. LAPS also contains Virtual Device 
Drivers which make the installed protocols available to DOS and Windows 
sessions under OS/2 without the need for specific DOS protocol drivers. 
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3. 1.1.2 Multiple Protocol Support 

NDIS allows multiple protocols to be bound to a single MAC driver, that is, to 
share a network adapter. Figure 20 shows the NDIS protocol stacks when 
NetBIOS, IEEE 802.2, and TCP/IP are loaded together. In this example, two 
LAN adapters are in use. NetBIOS and IEEE 802.2 are bound to one of the 
adapters, and the other adapter is dedicated to the TCP/IP protocol (although 
there is no reason why all three protocols could not have been bound to both 
adapters). The configuration information defining which protocol(s) is/are 
bound to which adapter(s) is contained in the PROTOCOL.INI file. 
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Figure 20. NDIS - multiple protocols 



3. 1.1.3 PROTOCOL.INI 

PROTOCOL.INI contains the NDIS configuration information for network 
adapter drivers and protocol drivers for a workstation. PROTOCOL.INI is an 
ASCII file that can be edited manually, but this is generally not recommended. 
We recommend that you always use the Adapter and Protocol Services 
configuration utility to ensure the creation of valid PROTOCOL.INI and 
CONFIG.SYS files. The PROTOCOL.INI file consists of four sections: 

• Protocol Manager 



Adapters and protocol services 57 



• Configuration 

• Protocol drivers 

• MAC (network adapter) drivers 

All these sections have the following structure: 
[module name] 
parameter=value 



The following is an example of a PROTOCOL.INI file configured with both 
NetBIOS and TCP/IP protocol stacks (similar to Figure 20). The first entry is 
the protocol manager, which is the driver that controls the binding process. 

[PROT_MAN] 

DRIVERNAME = PROTMAN$ 



The configuration section defines which protocols are used and what types of 
adapters are configured. In the following example, netbeui_nif and 
tcpbeui_nif are the protocol drivers, and IBMTOK_nif is the adapter 
configuration (in this case an IBM Token-Ring adapter). 

[IBMLXCFG] 

netbeui_nif = netbeui.nif 
tcpip_nif = tcpip.nif 
IBMTOK nif = IBMTOK.NIF 



The Bindings = statements under the various protocol drivers specify the 
module name of the MAC driver to which the protocol driver will bind to form a 
protocol stack or stacks. In this example, NetBIOS, the NetBIOS API is using 
the NetBEUI protocol driver, which itself is bound to the token-ring MAC 
driver. TCP/IP is also bound to the token-ring MAC driver. 



[NETBIOS] 

DriverName 
ADAPTERO = 
[netbeui_nif ] 
DriverName 
Bindings = 
[tcpip_nif ] 
DriverName 
Bindings - 
[IBMTOK_nif] 
DriverName 



= netbios$ 
netbeui$ , 0 

= netbeui$ 
IBMTOK_nif 

= TCPIP$ 
IBMTOK_nif 

= IBMTOK$ 



More statements of the kind of parameter = value may appear under each 
protocol and MAC section. The meanings of parameter and the allowed 
ranges and types for value are contained in network information (.NIF) files, 
which exist for each protocol and MAC driver. The configuration program 
parses those NIF files to check what can be configured for any given section 
in PROTOCOL.INI and whether a configuration item is valid. If no additional 
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parameters are specified in the PROTOCOL.INI sections, default values will 
be used as defined in the .NIF files. 

3.1.2 Socket/Multiprotocol transport services 

The Sockets interface allows you to develop distributed or client/server 
applications using various transport protocols. The application can select the 
transport protocol or request that the Socket/MPTS layer determine the 
protocol. Most socket applications available today communicate with either 
TCP or UDP 

Sockets are duplex, which means that data can be transmitted and received 
simultaneously. Sockets allow you to send to and receive from the socket as 
if you are writing to and reading from any other network device. 

Socket/MPTS provides the support for three kinds of address families for the 
Sockets Application Programming Interface (API): 

TCP/IP address family (AFJNET) 

NetBIOS address family (AF_NB) 

OS/2 address family (AF_OS2) 

It also provides a local IPC transport for Sockets applications (inter-process 
communications support that does not issue any calls to the network). 
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Figure 21 . Overview of Socket/MPTS 



3.2 Installing adapters and protocol services 

Since this component of OS/2 Warp Server for e-business provides 
communication support to all other parts of the product, it will always be 
installed when you install an OS/2 Warp Server for e-business. Therefore, it 
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cannot be explicitly selected in the OS/2 Warp Server for e-business Setup 
and Installation Menu. 



Note 

If you are installing OS/2 Warp Server remotely in unattended mode 
(response file installation method using CID), you must include the Adapter 
and Protocol Services component in the installation procedures. 

Otherwise, your system will not be able to access the LAN. 



Adapters and protocol services will attempt to detect and identify any LAN 
adapters that are installed in your system. See the 
\IBMCOM\MACS\READMAC.TXT file for a list of adapter drivers that are 
supplied with OS/2 Warp Server for e-business. However, only the first 
adapter that can be found will be automatically included in the configuration. 
You may add more adapters, and you may add additional adapter drivers that 
are not included in OS/2 Warp Server for e-business, which we will describe 
later in this chapter. 

As far as network protocols are concerned, the initial configuration of Adapter 
and Protocol Services depends on the features that you have selected to be 
installed. 

The following Figure shows a possible configuration menu during the 
installation of OS/2 Warp Server for e-business. 
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Figure 22. Adapter and protocol services configuration during the installation 

The following table summarizes the configuration parameters of this page 
and describes their purposes. 



Table 3. Adapters and protocol services installation 



Configuration Item 


Configuration Data 


Change Adapter 


Press this button if you want to change a network adapter for 
the current configuration. This may be necessary if the 
installation program could not detect your adapter 
configuration properly. 


Add adapter 


Press this button if you: 

1 . Want to add an adapter to your configuration 

2. Want to add a new adapter driver that is not supplied with 
Adapters and protocol services 

This will bring up the menu that is shown in Figure 23 on page 
64. 
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Configuration Item 


Configuration Data 


Add protocol 


Press this button if you: 

1 . Want to add a protocol to your configuration 

2. Want to add a new protocol driver that is not supplied with 
Adapters and protocol services. 

This will bring up the menu that is shown in Figure 24 on page 
65. 


Settings 


Press this button if you want to change the parameters for 
any item in the configuration list. This will bring up the menu 
that is shown in Figure 25 on page 66. 


Remove 


Press this button if you want to remove an item from the 
configuration list. You can only remove one item at a time. 




You can only remove an adapter if you have previously 
removed all protocols that have been associated with that 
adapter. 


Change number 


Press this button if you need to change the logical sequence 
in which a protocol driver will address adapters if this protocol 
has been associated with more than one adapter. Application 
programs will use these numbers when they issue calls to the 
network interface. 



If the LAN adapter in your system is not supplied with OS/2 Warp Server for 
e-business, but you have an NDIS compliant OS/2 device driver for that 
adapter, click on the Add adapter button. The following menu will appear: 



Adapters and protocol services 
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Add Adapter 



Choose the network adapter installed on this 
workstation. 



Network adapter 



I 

t. 



IBM Streamer Family Adapter (IBMMPC. OS2) 
IBM T-R Busmaster Server Adapter (IBMTRBM, 



IBM T - R Shared RAM Family (UP/ SMP, IBMTOK. 



IBM Token Ring Network 16/4 Adapter II (IBM16Tf.il 
IBM Token - Ring PCI Family Adapter (IBMTRP. OS; 
BM Turbo 16/4 Token-Ring PC Card (IBMTOKCS, | j 



Other adapter... 



Help 



Figure 23. Add adapter driver to Adapters and protocol services 

To add a supplied adapter to your configuration, select the appropriate driver 
from the list and press OK. To add a new adapter driver, select Other 
adapter..., then specify the source drive from where the new driver will be 
copied to your system. 

If you want to use a protocol that is not supplied with OS/2 Warp Server, but 
you have an NDIS-compliant OS/2 device driver for that protocol, click on the 
Add protocol button. The following menu will be shown: 
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Figure 24. Add protocol driver to Adapters and protocol services 

To add a supplied protocol to your configuration, select the appropriate driver 
from the list, then press OK. To add a new protocol driver, select Other 
protocol..., then specify the source drive from where the new driver will be 
copied to your system. 

Adding an adapter or protocol may affect the configuration of other OS/2 
Warp Server components; so, you may want to check the items on the 
configuration tree again. For instance, adding the NetBIOS over TCP/IP 
protocol will result in another LAN adapter, which can be selected for File and 
Print Sharing Services. 

If you want to view or change the configuration of any adapter or protocol 
driver, select the appropriate item on the list, then click on the Settings 
button. The following menu will be shown: 
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Parameters for IBM T-R Shared RAM Family (UP/SMP, IBMTDK.O 



Edit the parameters as needed. 




Parameters 


Value 




Adapter assignment 


Network adapter address 
Shared RAM address 
Maximum number of queued transmits 


6 




Number of receive buffers 


2 




Receive buffer size 


256 




Number of transmit buffers 
Transmit buffer size 
Full-Duplex 
Shallow Mode 


1 




lr~ 








Figure 25. Change settings in Adapters and protocol services 



3.3 Additional configuration for adapters and protocol services 

If you want to make changes to the configuration of Adapters and protocol 
services after OS/2 Warp Server for e-business has been installed, you can 
easily do so by using the Adapters and protocol services configuration 
program. To start this program, either click on the MPTS Network Adapters 
and protocol services icon in the System Setup folder or type MPTS at an 
OS/2 command prompt. 

Then, select Configure to bring up the following figure: 
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Configuie 



Select an item below, then select Configure. Once you return to 
this panel you can select another item or select Close to save 
your configuration. 

Adapters and Protocols Status 

©jLAN adapters and protocols Configured 

O Migrate a CM 1.3 .CFG file 



Socket/MPTS transport access 

TCP/IP Configuration Use TCP/IP product 

configuration 

O NetBIOS Socket access Hot configured 



Close 



Configure Remove 



Cancel 



Help 



Figure 26. Additional configuration of Adapters and protocol services 

Select LAN adapters and protocols and choose Configure to bring up the 
LAPS Configuration window. Use this configuration panel to select the LAN 
adapter(s) installed on the system and the protocols associated with them. 
Figure 27 shows an example of what Adapters and protocol services 
configuration might look like. 
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Adapter and Protocol Configuration 



Select a network adapter and then select protocols to go with it. 
Network Adapters 



1 No Network Adapter 



3Com 3C3X9 PCI Token Ring Adapte §1 
3Com EtherLink 16 (3c507) Familg 
3Com EtherLink II (3c503) Family - - 



1 
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Change Other adapters... 



Protocols 
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1 NetWare NetBIOS Emulatic] 
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5 


IBM Kernel Debug Network 


IBM IEEE 802.2 




IBM OS/2 NETBIOS 




< llllll 






Add 


Other protocols. 





Current Configuration 

To edit driver parameters, select an item below 
and then select Edit. 



IBM T-R Shared RAM Family (UP/SMP, IBMTOK. 



0 - IBM OS/2 NETBIOS 

0 - IBM TCP/IP 

1 - IBM OS/2 NETBIOS OVER TCP/IP J-j 









Edit 


Remove 


Change number... 



Select OK when 
complete. 



OK 



Cancel 



Help 



Figure 27. Adapter and protocol configuration 

The following table summarizes the use of this configuration menu. 

Table 4. Configuration menu items 



Configuration Item 


Configuration Data 


Network Adapters window 


Add 


Press this button if you want to add an adapter to your 
configuration. 


Change 


Press this button if you want to change a network adapter for the 
current configuration. 


Other adapters... 


Press this button if you want to add a new adapter driver that is 
not supplied with Adapters and protocol services. 


Protocols window 


Add 


Press this button if you want to add a protocol to your 
configuration. 


Other protocols... 


Press this button if you want to add a new protocol that is not 
supplied with Adapters and protocol services. 
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Configuration Item 


Configuration Data 


Current Configuration window 


Edit 


Press this button if you want to change the parameters for any 
item in the configuration list. This will bring up a menu where you 
can make changes to multiple parameters and then apply all 
changes at once 


Remove 


Press this button if you want to remove an item from the 
configuration list. You can only remove one item at a time. 




You can only remove an adapter if you have previously removed 
all protocols that have been associated with the adapter 


Change number... 


Press this button if you need to change the logical sequence in 
which a protocol driver will address adapters if this protocol has 
been associated with more than one adapter. Application 
programs will use these numbers when they issue calls to the 
network interface(s). 



If you have finished the configuration, press OK to save the changes. Press 
Close on the following panel, then press Exit. Select to update the 
CONFIG.SYS file on the OS/2 boot drive so that the configuration changes 
can be properly applied. You will need to reboot before the changes will 
become effective. 

3.3.1 Configuring Socket/MPTS 

Socket/MPTS is configured from the Configuration panel when loading MPTS 
(see Figure 26 on page 67). Use this panel to select the protocols that you 
intend to use for Socket access. These selections notify Socket/MPTS to 
initialize the protocol services required. The selectable protocols are: 

TCP/IP Socket access 
and 

NetBIOS Socket access. 

To select TCP/IP Socket access, you must have TCP/IP protocol configured 
(using the LAN Adapters and protocol services configuration option). To 
select NetBIOS Socket access, you must have the NetBIOS protocol 
configured (using the LAN Adapters and protocol services configuration 
option). You must select at least one protocol for your Socket/MPTS 
environment. However, you can select more than one protocol. 
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Note 

When you have installed TCP/IP Version 4.21, during the installation of 
your OS/2 Warp Server for e-business system or at any later time, you 
must use the TCP/IP Configuration notebook to configure TCP/IP 
parameters. 



3. 3. 1.1 Configuring TCP/IP Sockets access 

Since TCP/IP Version 4.21 and Java 1.1.7 all TCP/IP settings can only be 
made in the TCP/IP Configuration Notebook. 

3. 3. 1.2 Configure NetBIOS Sockets access 

Select NetBIOS Sockets access, then click on Configure. The following 
menu will be shown: 




Figure 28. NetBIOS socket access configuration 

On this page, you can configure the NetBIOS interface of your OS/2 Warp 
Server for e-business system for Socket access. The following table 
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summarizes the configuration parameters of this page and describes their 
purpose. 

Table 5. NetBIOS Interface configuration for socket access 



Configuration Item 


Configuration Data 


Sessions 


Specify the number of NetBIOS sessions you want to reserve 
for Sockets applications. The number of sessions specified 
here will be taken from the total number of sessions specified in 
the NETBEUI section of the PROTOCOL.INI file. This means 
that the amount of sessions available to other NetBIOS 
applications, such as File and Print Sharing Services, will be 
reduced by the number specified here. 


NCBs 


Specify the number of NetBIOS commands (NCBs) you want to 
reserve for Sockets applications. The number of NCBs 
specified here will be taken from the total number of NCBs 
specified in the NETBEUI section in the PROTOCOL.INI file. 
This means that the number of NCBs available to other 
NetBIOS applications, such as File and Print Sharing Services, 
will be reduced by the number specified here. 


Names 


Specify the number of NetBIOS names you want to reserve for 
Sockets applications. The number of NCBs specified here will 
be taken from the total number of names specified in the 
NETBEUI section in the PROTOCOL.INI file. This means that 
the number of names available to other NetBIOS applications, 
such as File and Print Sharing Services, will be reduced by the 
number specified here 


NetBIOS hostname 


Enter the hostname that your NetBIOS Sockets application will 
be using. 


View Details... 


Click here to see more available hostnames. When the 
NetBIOS protocol is configured to more than one adapter, 
Socket/MPTS will use the hostname you have specified for the 
first interface, and it will add to that name unique identifiers 
(consecutive numbers) and use them as hostnames for the 
other interfaces. 



When you finished the Sockets Access Configuration, click on Close to return 
to the Configuration menu. 

You can use the netstat command to see whether the NetBIOS Sockets 
interface is initialized and what applications are currently using it. 

3. 3. 1.3 Removing Socket/MPTS configuration 

When you want to remove a Socket/MPTS configuration from your OS/2 
Warp Server system, you can do it from the Configure panel when loading 
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MPTS. Select the appropriate Socket access protocol to be removed (TCP/IP 
or NetBIOS), then click on Remove. If you want to remove both protocols, 
you can do so by removing one after the other. 

Note 

Removing a Socket access protocol will not remove the protocol driver 
from the LAN adapter and protocol configuration. It will only update the 
\MPTN\BIN\MPTCONFG.INI file and remove device drivers from the 
CONFIG.SYS file. 



3.3.2 NETBEUI parameters 

The NETBEUI section of the PROTOCOL.INI file has two particular 
configurable parameters: SIDEBAND and BALANCE. These parameters 
should not be changed from their default values. When not present in the 
PROTOCOL.INI file, these two parameters are set to the correct values 
automatically. The default values (when not present in PROTOCOL.INI) are 
as follows: 

• SIDEBAND = 1 

• BALANCE = 2 

Setting SIDEBAND to 1 enables a performance enhancement used by File 
and Print Sharing Services for sending small frames. Setting SIDEBAND to 0 
disables this performance enhancement. 

BALANCE is used to control how NetBEUI chooses which adapters are used 
when an ncb. listen command is issued on a machine with multiple network 
adapters. If two network adapters on the same machine are on the same 
network segment (bridged segment), setting BALANCE to 0 disables load 
balancing; setting BALANCE to 1 puts it into load balancing mode; and, 
setting BALANCE to 2 lets NetBEUI decide the appropriate load balancing 
mode. 

3.3.3 Configuring more than four LAN adapters 

As discussed below, Adapter and Protocol Services itself is not limited to four 
adapters as is the NB30 NetBIOS API. Adapter and Protocol Services 
support includes LAN adapters as well as other NDIS communication adapter 
drivers, such as asynchronous and parallel port support, WAN, and ISDN. 
The number of adapter drivers that can actually be used concurrently differs 
between the NDIS protocol drivers. The TCP/IP, IEEE 802.2, and NetWare 
Requester Support protocol drivers can support up to 64 adapters. The 
NetBIOS protocol drivers (IBM NETBEUI, IBM NetBIOS over TCP/IP, and 
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NetWare NetBIOS Emulation) will only support four adapters, which is the 
limit of the NB30 NetBIOS API. 

Since all NetBIOS drivers that are supplied with OS/2 Warp Server also 
support the LM10 NetBIOS API, there is no restriction to four adapters when 
this interface is used by applications. This will increase the number of clients 
that can be simultaneously connected to OS/2 Warp Server over NetBIOS. It 
will also help the session load balancing performed by File and Print Sharing 
Services. 

In the following example, we used four DUAL Auto LANStreamer adapter 
cards that provide two separate token-ring ports each. This gives us a total of 
eight LAN adapters as seen by NDIS. Figure 29 on page 74 shows how these 
adapters can be interfaced by NetBIOS applications. NB30 applications will 
only be able to interface with four adapters, whereas LM10 applications, such 
as File and Print Sharing Services, will be able to interface with all eight 
adapters that are bound to the NetBEUI protocol driver. 
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Figure 29. NetBIOS configuration for eight adapters 

The following lines are extracted from the CONFIG.SYS file to reflect what 
drivers must be loaded in order to support the configuration as shown above: 



DEVICE=C : \IBMCOM\MACS\DUALSTRM . OS2 /S : 3 
DEVICE=C : \ I BMCOM \MAC S \ DUAL S TRM . OS2 /S : 4 
DEVICE=C : \ I BMCOM \MAC S \ DUAL S TRM . OS2 /S : 6 
DEVICE=C : \IBMCOM\MACS\DUALSTEM . OS2 /S : 7 
DEVI CE=C : \ IBMCOM\LANMSGDD . OS2 / I : C : \ IBMCOM 
DEVICE=C : \IBMCOM\PROTMMJ .OS2 /I : C: \ IBMCOM 
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Note 

• You have to add the lines for the DUALSTRM.OS2 device driver 
manually. 

• Make sure you add those lines before the PROTMAN.OS2 device driver 
statement as shown in the example above. 

• Include the /S parameter on every statement to specify the slot that the 
Dual LANStreamer adapter is plugged into. 



The following lines are extracted from the PROTOCOL.INI file to reflect what 
drivers must be loaded to support the configuration as shown above: 

[PROT_MAN] 

DRIVERNAME = PROTMAN$ 

[IBMLXCFG] 

netbeui_nif = netbeui.nif 
IBMMPC_nif = IBMMPC.NIF 
IBMMPC_nif 2 = ibmmpc.nif 
IBMMPC_nif 3 = ibmmpc.nif 
IBMMPC_nif4 = ibmmpc.nif 
IBMMPC_nif5 = ibmmpc.nif 
IBMMPC_nif6 = ibmmpc.nif 
IBMMPC_nif7 = ibmmpc.nif 
IBMMPC_nif8 = ibmmpc.nif 

[NETBIOS] 

DriverName = netbios$ 

ADAPTERO = netbeui$,0 
ADAPTER1 = netbeui$,l 
ADAPTER2 = netbeui$,2 
ADAPTER3 = netbeui$,3 

; only four adapters may be initialized here - that's the NB30 interface 



[netbeui_nif ] 



DriverName = netbeui$ 

Bindings = IBMMPC_nif , IBMMPC_nif 2 , IBMMPC_nif3 , IBMMPC_nif4 , 
IBMMPC_nif 5 , IBMMPC_nif 6 , IBMMPC_nif 7 , IBMMPC_nif 8 

the Bindings statement must go on a single line 

ETHERAND_TYPE = "I" 

USEADDRREV = "YES" 

OS2TRACEMASK = 0x0 
SESSIONS =254 
NCBS =254 
NAMES = 42 
SELECTORS = 15 
USEMAXDATAGRAM = "NO" 

ADAPTRATE - 1000 
WINDOWERRORS = 0 
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MAXDATARCV - 4352 
TI = 30000 
T1 = 1000 
T2 = 200 
MAXIN = 1 
MAXOUT = 1 

NETBIOSTIMEOUT = 2000 
NETBIOSRETRIES = 3 
NAMECACHE = 1000 
RNDOPTION = 1 
PIGGYBACKACKS = 1 
DATAGRAMPACKETS =10 
PACKETS = 330 
LOOPPACKETS = 8 
PIPELINE = 5 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
DLCRETRIES =10 
FCPRIORITY = 5 
NETFLAGS = 0x1000 

[IBMMPC_nif] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEof Int = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 2 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEof Int = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 3 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEof Int = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
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HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 4 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 5 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 6 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 

[ IBMMPC_ni f 7 ] 

DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEoflnt = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 
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[ IBMMPC_ni f 8 ] 



DriverName = IBMMPC$ 
MaxTransmits = 31 
MaxTxFrameSize = 18000 
MinRcvBuffs = 20 
SizWorkBuf = 2048 
MulticastNum = 16 
EnableTxEof Int = "YES" 
Enet20UTP = "NO" 
EnableHiPriTx = "NO" 
HiPriTxAccess = 5 
HiPriTxThresh = 4 
LLCOnly = "NO" 



The following lines are extracted from the LANTRAN.LOG file to reflect what 
messages will be logged when the Adapter and Protocol Services device 
drivers are initialized and a configuration as shown above is being used: 



IBM OS/2 LANMSGDD [02/16/99] 5.05 is loaded and operational. 

IBM OS/2 NETBEUI 5.50.0 

NETBEUI: Using a 32 -bit data segment. 

Installing NETWKSTA .200 Version 6.0. IBM LAN Redirector ( Feb 16, 1999) 

IBM OS/2 NETBIOS 4.0 

Adapter 0 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 1 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 2 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

Adapter 3 has 34 NCBs, 153 sessions, and 28 names available to NETBIOS applications. 

NETBIOS 4.0 is loaded and operational. 

IBM Streamer Family adapter NDIS device driver Version 4.01.00 
Initialization proceeding for section IBMMPC_NIF in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF2 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF3 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF4 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF5 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF6 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF7 in PROTOCOL.INI 
Initialization proceeding for section IBMMPC_NIF8 in PROTOCOL.INI 
IBM LANVDD is loaded and operational . 

IBM OS/2 LAN Netbind 

Slot 3A: IBM Streamer Family adapter universal address is 08005a6c072c 

Slot 3A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 3B: IBM Streamer Family adapter universal address is 08005a6c072d 

Slot 3B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 4 A : IBM Streamer Family adapter universal address is 08005a6c08a8 

Slot 4 A : IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 4B : IBM Streamer Family adapter universal address is 08005a6c08a9 

Slot 4B : IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 6A: IBM Streamer Family adapter universal address is 08005a6cdlla 

Slot 6A: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 6B: IBM Streamer Family adapter universal address is 08005a6cdllb 

Slot 6B: IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 7A : IBM Streamer Family adapter universal address is 08005ale4772 

Slot 7A : IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 

Slot 7B : IBM Streamer Family adapter universal address is 08005ale4773 

Slot 7B : IBM Streamer Family adapter opened for: Token Ring, 16 Mbps. 
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The following lines are extracted from the IBMLAN.INI file to reflect what 
statements must be configured to support the configuration as shown above: 



[networks] 



netl = NETBEUI $, 0,LM10, 101,220, 14 
net 2 = NETBEUI $, 1,LM10, 101,220, 14 
net 3 = NETBEUI $, 2, LM10, 101,220, 14 
net 4 = NETBEUI $, 3, LM10, 101,220, 14 
net 5 = NETBEUI $, 4, LM10, 101,220, 14 
net 6 = NETBEUI $ , 5 , LM10 , 101 , 220 , 14 
net 7 = NETBEUI $, 6, LM10, 101,220, 14 
net 8 = NETBEUI $, 7, LM10, 101,220, 14 



[requester] 



wrknets = netl,net2, net3,net4 / net5 / net6 / net7,net8 



[server] 



srvnets = netl / net2 / net3,net4 / net5 / net6,net7,net8 



3.3.4 DOS and Windows LAN applications on OS/2 

Adapter and Protocol Services also provide virtual device drivers to allow 
DOS and Windows applications to use the NetBIOS and IEEE 802.2 protocol 
services. The device drivers are loaded when the following statements are 
contained in the CONFIG.SYS file: 

DEVICE=F:\IBMCOM\PROTOCOL\LANPDD.OS2 

DEVICE=F:\IBMCOM\PROTOCOL\LANVDD.OS2 

LANPDD.OS2 is the virtual IEEE 802.2 protocol driver, and LANVDD.OS2 is 
the virtual NetBIOS protocol driver for DOS and WIN-OS2 sessions. Both 
drivers are required to support any of these interfaces on DOS and WIN-OS2 
sessions. These statements will be added by Adapter and Protocol Services 
automatically when you configure the NetBIOS or IEEE 802.2 protocol for at 
least one adapter. 

To reserve NetBIOS and IEEE 802.2 resources for a DOS or WIN-OS2 
session, you have to include the ltsvcfg command in the AUTOEXEC.BAT 
file. This command takes to following parameters: 
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LTSVCFG 

C = number of NetBIOS commands 
D = IEEE 802.2 direct station support 
N = number of NetBIOS names 
N1 = NetBIOS name #1 support 
S = number of NetBIOS sessions 
/ separator between multiple adapter configurations 



The resources specified with the ltsvcfg command are taken from the pool of 
resources that is defined in the PROTOCOL.INI file. The MPTS Configuration 
Guide on-line book provides configuration and application settings examples 
for the virtual device drivers. 

3.3.5 NetBIOS over TCP/IP on OS/2 Warp Server for e-business 

Clients and servers need to know how to find one another in order to share 
information. The NetBIOS conventions built into DOS and OS/2 
clients/servers use 16 byte NetBIOS names, which refer to one another by 
name. Different applications on the same PC use different names to 
represent their applications. 

NetBIOS names, such as Corinna’s PC, Server F.v.S-Marketing or 
LAB-Printer IBM1 can be built into programs or solicited from humans with 
relative ease. NetBIOS names can be used as unambiguous identifiers even 
if a station is moved to another location. However, to send one another 
packets of information, the TCP/IP protocol drivers of the respective PCs 
must refer to one another by IP address. The problem then exists of having to 
translate NetBIOS Names into IP addresses in order to effect PC-to-PC 
communication on an IP network. 

To date, this translation has been handled in one of two ways: by use of static 
tables residing on each client and server, or by the use of (dynamic) 
broadcast queries (packets sent to every client and server) asking in effect 
"Where is Corinna’s PC?" 

The problem with static tables is that they must be continually updated and 
maintained, an activity far more troublesome than the maintenance of IP 
addresses alone. Every time any new station is added to the network, all of its 
applications' names must be added to the static table of each other station 
that wants to send it data. And with static entries, though the name is always 
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mappable, there is no telling whether the named application is actually active 
at the time interaction is desired by another station. 

The problem with broadcast queries is that IP networks cannot propagate 
broadcasts beyond a single (logical) cable segment. Resources located on 
the other side of a router from the broadcasting station will not receive the 
query. Every station on the same side of the router will be pestered with 
queries for which it doesn't know the answer. 

A NetBIOS over TCP/IP protocol has been defined by the governing TCP/IP 
standards body, the Internet Engineering Task Force (IETF), which 
overcomes each of these problems. The IETF standard describes how 
NetBIOS stations may interact with a NetBIOS Name Server in order to 
dynamically register their own application names and to learn the 
name-to-address mappings of other applications. 

Several components of OS/2 Warp Server can use NetBIOS for 
communications, but they can also use other protocols like TCP/IP or IPX. 
File and Print Sharing Services remains the only OS/2 Warp Server 
component that can only use NetBIOS as a programming interface. 

The original NetBIOS protocol has some specific characteristics which limit 
its use in certain wide area network environments: 

• The NetBIOS protocol uses a flat name space. 

• The NetBIOS protocol relies on the broadcast technique to register/find a 
name. 

• The NetBIOS protocol cannot be routed. 

One solution to overcome these limitations can be found in RFCs 1001 and 
1002. They describe the standard way to implement the NetBIOS services on 
top of the TCP and UDP protocols. Adapter and Protocol Services provide a 
full TCP/IP protocol stack and a TCPBEUI protocol stack, which is a ring 0 
implementation of RFC 1001/1002. 

Another solution of routing NetBIOS is to use the NetBIOS over IPX protocol 
driver, which is also supplied with Adapter and Protocol Services. 
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Note 



In order to use NetBIOS over TCP/IP, you do not need to install the TCP/IP 
Services of OS/2 Warp Server for e-business since the support for this 
combination of protocols is fully included in Adapters and protocol services. 
TCP/IP Services of OS/2 Warp Server means TCP/IP applications on top of 
the TCP/IP protocol, such as FTP, LPR, DHCP and DDNS. 



The capability of running NetBIOS applications over routable protocols offers 
new flexibility when designing OS/2 Warp Server for e-business networks. 
OS/2 Warp Server for e-business systems, OS/2 Warp Server, Warp Connect 
Peer workstations, LAN Servers, and LAN Requester workstations can be on 
remote LAN segments connected by IP routers. This also means that such 
systems can be introduced into existing TCP/IP networks without introducing 
an additional network protocol (NetBIOS). There are several defined classes 
of NetBIOS over TCP/IP implementations specified by RFCs 1001 and 1002. 

3. 3. 5.1 Resolving NetBIOS names to IP addresses 

When the client connects to the server, the client must resolve the server’s 
NetBIOS names. There are various ways to resolve NetBIOS names into IP 
addresses. 

The simplest method is to try broadcasting name queries and hope the 
computer you are trying to communicate with responds in order to do the 
resolution. Computers running this mode are said to be a Broadcast Node 
(B-Node). One disadvantage in a large network environment is that broadcast 
traffic becomes a nuisance or is so dispersed that broadcasts cannot be 
made to reach all stations. 

A better method would be to have a server on the network that could do the 
NetBIOS name to IP address resolution for us. Such a server is known as a 
NetBIOS Name Server or NBNS. Computers that are configured to use an 
NBNS are Peer-to-Peer Note (P-Node) clients. Broadcasting is never used by 
P-Node clients. 

Finally, we could combine the modules to become either Mixed Node 
(M-Node) or Hybrid Node (H-Node) clients. 

An M-Node client will attempt a name query broadcast first, and, if that fails, it 
will try to use the NBNS. 

H-Node clients will attempt a name query broadcast first, and, if that fails, will 
try a name query broadcast. If an H-Node client detects that an NBNS has 
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failed, it will continue to poll the NBNS (while using broadcast) so that it 
knows when to switch back to using the NBNS. H-Node has generally 
replaced M-Node. 

3. 3. 5. 2 Additional information about OS/2 TCPBEUI 

OS/2 TCPBEUI is a high performance, ring 0 implementation of NetBIOS 
over TCP/IP. TCPBEUI provides the LM10 protocol driver interface. It is the 
same LM10 functionality that is also provided by NetBEUI. Figure 30 shows 
this interface. TCPBEUI maps NetBIOS API calls into the TCP/IP protocol. 
NetBIOS over TCP/IP contains enhancements over the B-node standard 
which improves system performance by decreasing broadcast frames and by 
expanding communications over routers and bridges. These enhancements 
are transparent to NetBIOS applications and do not interfere with other 
B-node implementations that lack similar functions. 

RFC 1001/1002 is not an encapsulation technique, but, rather, builds special 
packets and sends them out via UDP and TCP. For example, once a NetBIOS 
session has been established, TCPBEUI will use sockets-send commands 
over a TCP connection to send NetBIOS session data. TCPBEUI builds a 
four-byte session header that precedes the actual user data. Thus, a 
NetBIOS Chain Send of 128KB would have an overhead of only four bytes. 

TCPBEUI allows peer-to-peer communication over the TCP/IP network with 
other computers that have compatible services. Figure 30 shows the 
relationship between the NetBIOS, NetBIOS over TCP/IP, and TCP/IP 
protocol stacks as implemented in Adapter and Protocol Services. 
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Figure 30. NetBIOS, NetBIOS over TCP/IP and TCP/IP structure 

Unlike NETBEUI. 0S2, the TCPBEUI.0S2 program does not directly 
communicate with the NDIS interface. The dotted line in the figure indicates 
TCPBEUI has a BINDINGS statement in the PROTOCOL.INI file, but a bind 
process is only required in order to create a control block area. 

Figure 30 also illustrates how NetBIOS applications can use both NETBEUI 
and TCPBEUI protocol stacks. ACSNETB.DLL provides the ring 3 NetBIOS 
DLL API for application programs. Ring 3 NetBIOS commands are sent to 
NETBIOS. OS2 for processing. NETBIOS. OS2 provides the ring 0 NetBIOS 
DLL API for applications and other device drivers to use, and it binds to one 
or more LM10 (LAN Manager 1.0) transport protocol drivers. The LAN 
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redirector component of File and Print Sharing Services (NETWKSTA.200) 
and HPFS386 use the LM10 interface. 

Support for NetBIOS over TCP/IP can easily be added to the existing 
NetBIOS structure since the Warp Server Install program supports up to four 
LM10 interfaces. It is provided by having NETBIOS. OS2 bind to 
TCPBEUI.OS2. To enable NETWKSTA.200 to use TCPBEUI, there must be a 
NETx (where x is 1, 2, 3, 4, for example) statement in the IBMLAN.INI file 
configured appropriately. 

Data transfer to LAN is handled by a MAC device driver, for example, the 
IBMTOK.OS2 device driver. 

3. 3. 5. 3 TCPBEUI coexistence with NetBEUI 

Adapters and protocol services provide the capability of configuring NetBIOS 
applications, especially File and Print Sharing Services, with both NetBEUI 
and TCPBEUI on the same network interface card. This dual protocol stack 
configuration will allow local sessions to continue running with NetBEUI 
performance while also providing wide area network connectivity with 
NetBIOS over TCP/IP. 

Figure 31 shows an example scenario with both TCP/IP and NetBIOS 
protocols being used and TCP/IP Services installed on a server. In this 
example, LAN Client A is able to access File and Print Sharing Services 
resources on the OS/2 Warp Server B on the local LAN segment via 
NetBIOS, and the OS/2 Warp Server C on the remote LAN segment across 
the IP network via TCPBEUI. In addition, it is able to use the TCP/IP 
applications provided by TCP/IP Services to access local and remote TCP/IP 
hosts via the native TCP/IP protocol. 



Adapters and protocol services 85 





OS/2 Warp Connect 
OS/2 LAN Requester 
DOS LAN Services 
Windows 95 
Windows NT 



Figure 31. Coexistence TCPBEUt 



Note 

When configuring Adapter and Protocol Services for both NetBEUI and 
TCPBEUI, even though a single LAN adapter is present in the workstation, 
the two protocols need to be configured on different logical adapters. File 
and Print Sharing Services handle this configuration as if there were two 
adapters present. Therefore, two NET entries will be made in IBMLAN.INI. 
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3.4 MPTS - Strong encryption 

The strong encryption replacement version of MPTS is part of the IBM OS/2 
Warp Server for e-business Security Feature. This consists of two CDs. CD 1 
contains the replacement version of Multi-Protocol Transport Services 
(MPTS). CD 2 contains Lotus Domino Go Webserver 4. 6. 2. 6 and IBM 
WebSphere (TM) Application Server 1.1. 

This version of MPTS contains the SSL and IPSEC libraries used by other 
applications. The IPSEC libraries provide 56-bit encryption, and the SSL 
libraries provide 56/128-bit encryption depending on your location. This 
version of MPTS supports strong encryption for Lotus Domino Go Webserver 
4. 6. 2. 6 and IBM WebSphere Application Server 1 .1 . 

To install this version of MPTS, perform the following steps: 

1 . Insert the OS/2 Warp Server for e-business Security Feature CD 1 into the 
CD-ROM drive. 

2. Open an OS/2 window. 

3. From an OS/2 command prompt, type e: and press Enter, e is the drive 
letter of the CD-ROM drive. 

4. Type cd npts and press Enter. 

5. Type cd language and press Enter, language is the two-character 
abbreviation of the language version you are installing. 

6. Type install and press Enter. 

7. Follow the displayed installation instructions. 

This will replace a number of the MPTS component files that are installed 
onto your hard disk. You will need to reboot to make those changes effective. 



3.5 Removing adapters and protocol services 

Since Adapters and protocol services are a key feature of OS/2 Warp Server 
for e-business providing communications support to all other components, it 
should not be removed. Nevertheless, you can remove MPTS/LAPS by 
pressing the Remove Button in the Configuration Menu. 
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Chapter 4. Journaled file system and logical volume manager 



There has been a rapid explosion in the data storage requirements of today’s 
corporate servers especially when they are used to house information for the 
Internet. This rise in storage capacity has facilitated the need for improved file 
system management and recovery. Businesses want more convenient 
methods to expand with their disk requirements and no longer want to endure 
the lengthy file system recovery times that are the hallmarks of non-journaled 
file systems, such as FAT and HPFS. 

IBM’s OS/2 Warp Server for e-business introduces two key features to help 
meet these server demands - the Logical Volume Manager (LVM) and the 
Journaled File System (JFS). JFS is designed for high throughput and 
reliability as well as providing quick recovery times that are essential factors 
in improving server availability and performance. LVM helps balance dynamic 
file requirements by allowing partitions to be expanded dynamically and 
volumes to span across physical disks. 

This chapter begins with an introduction to data storage through a look at the 
enhanced bundled support of files systems. It will then take an in-depth look 
into the log-awaited additions of LVM and JFS to OS/2 Warp Server for 
e-business. 



4.1 OS/2 file system support 

A file system is essentially a hierarchical structure of directories with each 
directory containing either more directories (referred to as subdirectories) or 
files. The main purpose of the file system is to improve management of data 
by allowing the data to be organized and easily managed. 

OS/2 Warp Server for e-business comes bundled with support for the 
following types of file systems: JFS, FAT, FIPFS, HPFS386 (with proof of 
purchase), NFS and CDFS. This section summarizes the key features of 
each of the supported file systems and discusses where it would be most 
appropriate to use them. 

4.1.1 File allocation table 

One of the simplest methods for storing data on disk is with FAT. FAT is 
simply an unsorted linear table designed for locating directories and files. It 
has low memory and disk administrative overheads. Unfortunately, FAT was 
only designed for small disk systems, namely floppy disks, because it was 
optimized for performance by reading the FAT content into memory. With the 
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advent of large hard drives, FAT has become slow because memory cannot 
hold all the information required for the file transaction in memory. This has 
meant that the hard drives have had to make several head movements to 
read a single file, which has had the overall effect of slowing down the 
system. 

The original implementation of FAT had a partition limit of 32MB, which later 
got increased to 2GB. One of the biggest problems with FAT has been the 
automatic incremental jumps in cluster size with disk partition sizes (see 
Table 6). This has lead to large amounts of disk storage wastage for small 
files. For example, a file which is only 400 bytes long, when stored on a 
512MB disk, occupies an 8KB cluster which is a 95 percent waste of space. 
Another problem stems from the way pieces of data information are written to 
disk one after another in a chain starting from the outer edge of the disk filling 
towards the middle then starting at the outer edge again. This quickly leads to 
disk fragmentation as space forms in the middle of the chain from file 
deletion. As a file gets modified, parts of it can end up being stored in 
different areas of the disk resulting in excessive head movement and slow 
response times. Finally, FAT is restricted to an 8.3 naming convention, which 
often prevents meaningful names from being given to files. 



Table 6. Relationship between partition size and cluster size 



FAT Cluster Size 


Partition Size 


Cluster Size 


diskettes 


1 sector 


< 16MB 


2 sectors 


16 to 128MB 


4 sectors 


128 to 256MB 


8 sectors 


256 to 512MB 


16 sectors 


512 to 1024MB 


32 sectors 


1024 to 2048MB 


64 sectors 



Enhancements have been made to FAT under OS/2 to improve performance, 
such as large cache, lazy-writing, bad sector bypass and bitmap to track free 
clusters on disk. OS/2 also allows a FAT partition to have additional Extended 
Attributes (EAs). Since there is no room for these attributes in the FAT 
directory, OS/2 creates a separate hidden file, EA DATA. SF, on the disk 
volume and stores the EA information in this file. 
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FAT support is, largely, provided for transferring data between different 
operating systems and is commonly used on floppy disks and on OS/2 clients 
to allow DOS and Windows applications to run. FAT is also used on OS/2 
clients if the system has only a small hard drive (<100MB) and/or does not 
have much memory (<8MB) since FIPFS can end up reducing performance in 
these situations. 

4.1.2 High performance file system 

For OS/2, a new file system was created specifically for the multitasking 
environment and with large disk support in mind. HPFS also followed a new 
concept in file system implementation called the Installable File System (IFS). 
An IFS driver, which contains code needed to manage media formats other 
than DOS to be loaded during the system boot phase. 

FIPFS has, by design, a better structure that prevents data fragmentation. 
This is due to the new disk layout whereby the tables that describe the 
location of files and freespace are positioned at regular intervals throughout 
the partition from the center of the disk. Also, new file and directory 
information is written where there is enough freespace. This reduces 
fragmentation and prevents excessive movement of the disk arm. FIPFS 
maintains a 512byte allocation unit (cluster size) no matter how large the 
partition becomes and also supports long file names up to 255 characters. 
Critical for the high performance of FIPFS is the caching technology it uses to 
access the disk. The lazy-write design writes data to a memory cache before 
writing to disk giving faster overall performance. The drawback is that data is 
lost if the computer is suddenly turned off preventing the cache from being 
written to disk. 

Data location by the file system is also improved in FIPFS through the use of 
a sorted B-tree (Balanced tree) structure to store the file information. This 
speeds up the search for files since FIPFS can quickly transverse down the 
correct branch of the tree to locate the file, whereas FAT has to look 
sequentially through an unsorted linear table. The drawback of the process is 
that it takes slightly longer to write the file, but this is greatly compensated for 
by the speed of locating a file. 



Note 

In the majority of cases, FIPFS will be superseded by the JFS with the 
exception of boot partitions because the JFS is not yet bootable. The boot 
partition needs to be either HPFS or HPFS386 since it is needed by Java 
for longname support. Many OS/2 Warp server for e-business configuration 
notebooks have been written in Java. 
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4.1.3 HPFS386 



With the release of the 80386 (and higher) class of microprocessors, the 
HPFS design was able to be further enhanced and tailored for the networking 
environment resulting in a new version of HPFS called HPFS386. Bundled 
with the Advanced version of the server code, HPFS386 provided extremely 
fast access to large disk volumes and optimized performance in the server 
environment. 

HPFS386 was developed to tightly integrate with the server code at ring 0 
allowing data to be transferred directly from the HPFS386 cache to the 
network adapter driver. This resulted in accelerated network I/O leading to 
faster data access by clients. Other features incorporated into HPFS386 were 
greatly increased cache size, local security, software fault tolerance support 
for RAID-1 (mirroring and duplexing), directory/user-based disk space 
limitation, and increased file access related limits. An advantage introduced 
with HPFS386 was the storage of access control lists (ACLs) within the 
directory and file structures, thus, making fast user verifications leading to 
quicker client access to the file. ACL information in HPFS is stored in a 
separate file called NET.ACC; the overhead of accessing this file slows down 
verification. 

HPFS386 is ideal in print server environments. For file server 
implementation, the decision between HPFS386 and JFS is dependent upon 
the server configuration; see Chapter 4.3.8, “Performance considerations” on 
page 142 for more details. The biggest drawback with HPFS386 comes when 
there is a system crash of the server with large amounts of disk. Recovery 
still relies on chkdsk to check and fix disk errors, which can be a very time 
consuming process. 



Note 

JFS, in its first iteration, is not intended as a replacement for HPFS386 
since it does not support features like Local Security, which HPFS386 
provides. 



4.1.4 Journaled file system 

The JFS provides the same range of supported file system operations for 
organizing and managing physical files, which was traditionally provided by 
HPFS. However, in its first release, the JFS is not bootable. The JFS is 
created in a logical volume and can be expanded across disks to meet disk 
requirements. It supports both file and partition sizes of up to two attributes 
and can recover from a system crash within minutes. The JFS has been 
enhanced for performance scalability on Symmetrical Multiprocessor (SMP) 
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systems and for TCP/IP transactions making it ideal for Web and Lotus Notes 
data serving. Another feature of the JFS is its support of Sparse Files making 
it ideal for large databases. Sparse files allow large database structures to be 
defined but occupy only the amount of disk space that is consumed by the 
database, thus, a 2TB file can be created on a 2GB partition if there is less 
than 2GB of actual data to be stored. The JFS is explored in more detail later 
in this chapter. 

4.1.5 HPFS386 features not available with JFS 

FIPFS386 has, for some time, been the most significant file system available 
for OS/2. Many additional features have, overtime, been developed based on 
FIPFS386. Some of these features are not yet available for JFS. 

4. 1.5.1 DASD limits 

The current version of JFS shipped with OS/2 Warp Server for e-business 
does not support DASD limits. Depending on your requirements, there are 
several possible workarounds; two of them are: 

1 . Keep the resources that need directory limits on an HPFS386 formatted 
volume. 

2. Use CHKSTOR as a replacement if it is sufficient to send an alert to the 
Administrator when the limit is exceeded. 

4. 1.5. 2 Fault Tolerance 

There is no replacement for the FIPFS386 Fault Tolerance feature in JFS. 
Current server hardware usually comes with RAID adapters that can be used 
to perform this function as a hardware solution. 

If you still need to rely on the software disk mirroring provided by FIPFS386, 
you will need to keep HPFS386. 

4.1.6 Comparison of features of FAT, HPFS, and HPFS386 JFS 

The following table summaries the difference in features between FAT, HPFS, 
HPFS386 and JFS. 



Table 7. Feature comparison between FAT, HPFS, HPFS386, and JFS. 





FAT 


HPFS 


HPFS386 


JFS 


Cache 


14Mb 


2MB 1 


Unlimited 2 


Unlimited 2 


Max. no of file opens 


64000 


64000 


64000 


64000 


Max. no of file finds 


3072 


3072 


8192 


32768 



Journaled file system and logical volume manager 93 









FAT 


HPFS 


HPFS386 


JFS 


Max. partition size 


2GB 


64GB 


64GB 


2TB 


ACL Support 


NET.ACC 


NET.ACC 


in Fnode 


in Inode 


ACL Limit 


81 92 3 


8192 3 


unlimited 


unlimited 


Max. no of connections 


16384 


16384 


16384 


16384 


Max. no of Shares 


1500 


1500 


1500 


1500 


Max. no of file per 
directory 


51 2 4 on the 
root directory 


limited by 
DASD 5 space 


limited by 
DASD 5 space 


4 billion 


Bad block relocation 


No 


Yes 


Yes 


Yes via LVM 


Software Fault 
Tolerance 


No 


No 


Yes 


No 



1 With HPFS cache, the 2MB limit is due to limits imposed by the 16-bit IFS architecture. 
2 This would equate to approximately 1 GB, which would be shared between cache and heap. 
3 ACL is limited to 8192 for FAT, CDROMs and HPFS are the information is stored in the last 
half of NET. ACC. 

4 FAT imposes a limit on the root directory that can be 1 12 or less (especially if WIN95 long 
filenames need to be supposed). For Hard disks, it generally has a value of 256 or 512 
hardcoded in the boot sector. Although subdirectories are theoretically unlimited, performance 
can be seriously degraded if the number of files per directory is greater than number of buffers 
(set in config.sys) * 16. 

5 Direct access storage device. 

4.1.7 Network file system 

NFS allows files and directories located on remote UNIX file systems to be 
incorporated into the local file system and accessed as though they were a 
part of the local server. NFS has been available separately for OS/2, but, with 
OS/2 Warp server for e-business, it has been integrated into the server. This 
integration, then, allows the server to share these NFS mounted files and 
directories just like any other resource to its clients. 

4.1.8 CD-ROM file system 

This type of file system allows the contents of a CD-ROM to be accessed as if 
it were part of the local file system. 
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4.2 Logical volume manager 

Even with the rapid advances in DASD (Direct Access Storage Device), 
modern hard disk capacity still has not managed to satisfy corporate 
demands. Coupled with continual demands for increasing DASD storage, 
such as spanning across physical disks, a new solution was needed to 
simplify the management of DASD within OS/2. An integral part of the 
solution is the introduction of the Logical Volume Manager (LVM) with OS/2 
Warp Server for e-business. 

The Logical Volume Manager (LVM) provides an abstraction layer for the file 
system in that it makes the logical/physical makeup of the volume transparent 
to both applications and users. The LVM exploits new features of the 
underlying logical volume management system replacing the fdisk utility, 
thus, allowing flexible division, allocation, and management of the system 
disks. Logical Volume Manager(LVM.EXE or LVMGUI.CMD) replaces the 
Fixed Disk (FDISK) utility from the previous versions of OS/2. It provides all 
the function of FDISK and it provides additional features, such as disk 
spanning, dynamic resizing and sticky drive letters. 

4.2.1 LVM terminology 

There are a number of specialized terms used to describe the various entities 
that comprise the Logical Volume Manager. 

Physical partition 

A partition is a portion of the physical disk that functions as though it were 
physically a separate unit. Each partition can be either a primary or an 
extended partition. The first physical disk must always have a primary 
partition. A primary partition is a bootable partition that cannot be subdivided 
any further, whereas, an extended partition is one that can be subdivided into 
smaller (logical) partitions. 

Logical partition 

A logical partition is a subdivision within an extended partition, which is seen 
as a separate unit. 

Logical volume 

A logical volume can define a single partition or a collection of partitions. 
Logical volumes are presented to the user/application as a single unit, thus, 
the single drive letter. Logical volumes can be of two types: Either 
Compatibility (to older versions of OS/2) whereby they are formatted FAT or 
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HPFS, or, they are LVM whereby only the Logical Volume Manager will 
recognize them. An LVM volume can be formatted either FAT, FIPFS, or JFS 
but cannot be made bootable, and, if formatted, JFS can be dynamically 
increased. 

Figure 32 on page 97 shows the relationship between these component 
terms. 

4.2.2 Overview of LVM 

The objective of LVM is to provide a logical layer for the support of Logical 
Volumes for the OS/2 DASD I/O Subsystem. With the introduction of LVM 
support, a volume is no longer restricted to a logical partition wholly 
contained on a physical drive. Disk spanning is available. Also, dynamic 
partition resizing for JFS volumes is supported. This is best summarized by 
Figure 32 on page 97; it shows a partition spanned across three disks. Figure 
32 also outlines the structure of how information is stored on the disk, the 
aggregate and the storage of data within it, and the fileset. 



96 Inside OS/2 Warp Server for e-business 





Note 

Only volumes that have not been formatted or are formatted JFS can be 
expanded. If a volume gets formatted with a file system other than JFS, it 
can no longer get expanded. 



Figure 33 on page 98 illustrates the expansion of a JFS volume using 
LVM.EXE. In this example, the volume was expanded across two different 
physical disks. 
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a 


LVM. EXE 


2| cj |d| 




Logical Volume Management Tool - Logical View 


1 



Logical Volume Type Status File System Size (MB) 



Aurora 

data 

test99 

test 



|Expand Vo l 



Compatibility 

Compatibility 

Compatibility 

LVM 



Bootable 



HPFS 

HPFS 

HPFS 

JFS 



1027 

1027 

2000 

3001 

ToToTS 



Disk Partition 


Size (MB) 


Disk Name 


Vol 1 


1002 


Diskl 



Fl=help F3=exit F5=Physical VietJ Enter=Options Tab=Uindou 



Figure 33. Expanding a volume, initial 

Initially, the LVM volume called Expand Vol (G:) in Figure 33 on page 98 has only 
one volume of size 1GB in it on Disk 1 formatted JFS. 




Figure 34. Expanding a volume, adding space 
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An additional 1GB is added to the volume in Figure 34 on page 98 from the 
second physical hard disk. 




Figure 35. Expanding a volume, completed 

In the lower portion of the screen in Figure 35 on page 99, you can now see that 
the volume Expand Vol now consists of two partitions: Vol 1 (Disk 1) and Vol 2 
(Disk 2). 



4.2.3 LVM and FDISK 

Figure 36 on page 100 is a comparison of LVM and FDISK concepts. 
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FDISK 



LVM 



Partition - A physical segment on a hard disk 



Logical Volume - May consist of 

one or more partitions; treated 

as if it were a single contiguous partition 



Primary 
partition is 
equivalent 
to a drive. 



C: 



D: 



primary primary extended 



Extended 
partition 
may include 
one or more 
logical partitions. 



Partitions 
cannot be 
linked 
across 
hard disks; 
must be 
contiguous. 



DISK 1 



DISK 2 



C: 


— — 

D: 


E: 


F: 




C: 


D: 


E: 


F: 




G: 


H: 


1: 



Drive letters are assigned by system 
in alphabetical order. 



Volume may 
consist of 
one partition 
as in FDISK. 



Volume may 
consist of 
one or more 
partitions; may 
be noncontiguous. 



DISK 1 

LVM volume 
may be 
linked across 
one or more 
hard disks. 

DISK 2 



C: 



D: 



partition partition partition 




Drive letters are assigned by user, 
or default to assignment by system 
in alphabetical order. 



Figure 36. Comparison chart of FDISK and LVM concepts 

4.2.4 Key components of the LVM 

In order to implement the LVM functionality, some existing OS/2 components 
have been modified and a number of new components added. This section 
discusses these components. 



4. 2. 4.1 Installable File System Manager (IFSM)/Kernel 

The IFSM no longer communicates with the DASD (Direct Access Storage 
Device) I/O subsystem in terms of logical/physical location but instead in 
terms of logical volumes. This is accomplished by introducing an intermediary 
filter between the disk and the DASD manager (OS2DASD.DMD) called 
OS2LVM.DMD. OS2LVM.DMD also handles the drive letter assignments 
reported to OS2DASD, thus, allowing dynamic drive letter allocation. This 
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gives IFSM the capability to dynamically mount and unmount drives as part of 
the disk partitioning process and handle removable media with differing 
numbers of partitions. 

The performance and SMP scalability has been improved by converting parts 
of the existing kernel execution environment (KEE) and IFSM from 16-bit to 
their 32-bit equivalent (namely KEE32 and IFSM32). This new kernel 
execution environment is used by JFS, LVM, OS2DASD, and TCP/IP. The 
32-bit code provides the following benefits: 

• The kernel File System Router layer, JFS, and OS2DASD (I/O path) 
are 32-bit resulting in improved execution time. The number of 
segment register loads is minimized. 

• The I/O size is not limited to <64 KB in the 32-bit File System Router. 
Therefore, the router makes a single call to JFS for large application 
I/O sizes. 

• The kernel File System Router will not acquire the spinlock (used to 
serialize access to a resource in an SMP or UNI environment) prior to 
calling the 32-bit JFS entry points for DosRead, DosWrite, and 
DosChgFilePtr. JFS/LVM/OS2DASD will use the new KEE spinlock 
APIs to provide more granular locking of its data structures resulting in 
improved SMP scalability. The spinlock will be acquired just prior to 
calling the DASD ADD and represents only a small percentage of the 
total I/O path. 

• Prior to calling the JFS entry points, the kernel stack selector is 
switched from a 16-bit to a 32-bit selector. This eliminates the need for 
JFS/LVM/OS2DASD to perform SS to DS segment register 
conversions. 

• The system services (KEE calls) are 32-bit and do not use a router. 
They are resolved by the OS/2 loader using KEE. LIB and the fix is 
applied directly to the calling code. The code path for a call is 
significantly reduced. 

4. 2. 4. 2 Device Manager - OS2LVM.DMD 

OS2LVM is a new component. As mentioned above, it sits between the IFSM 
and OS2DASD providing the logical view of the DASD to the OS/2 file 
system. OS2LVM also provides Bad Block Relocation (BBR) for JFS; HPFS 
does its own BBR. 
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Note 

The statement BASEDEV=OS2LVM.DMD must immediately follow the 
BASEDEV=OS2DASD.DMD statement in config.sys. 



4. 2. 4. 3 DASD Device Manager - OS2DASD.DMD 

OS2DASD has been modified to become the physical interface to the DASD 
I/O subsystem. Requests are received from the OS2LVM as physical writes 
and reads to physical partitions. At initialization, OS2DASD communicates 
with OS2LVM in order to compile and retain a current logical/physical view of 
the attached DASD devices. 

OS2DASD has been enhanced with 32-bit (called Strat3) entry points for 
handling calls from OS2LVM for JFS. HPFS and FAT still use the 16-bit 
Strat1/Strat2 calls. Since these calls are in 32-bit code, they benefit from a 
32-bit flat address model and KEE32 kernel calls which result in improved 
performance. 

Note 

The 16-bit device driver strategy commands used by FAT & FIPFS are 
referred to as Strati and Strat2. Strati commands are passed in via 
Request Packets and block the calling thread until completion while Strat2 
(Strat3 is a 32-bit implementation) commands are passed via a Request 
List and return on the calling thread prior to completion. 

This is summarized by Figure 37 on page 103. 
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Figure 37. Block diagram summarizing DASD I/O path 

4. 2. 4.4 LVM.EXE - Fixed Disk Utility 

The new logical volume management tool, LVM.EXE, is a replacement for 
FDISK. It provides the capability to manage the system disks, however, it 
moves the emphasis from working from the physical to the logical view of the 
disk subsystem. LVM.EXE allows the creation of partitions as well as logical 
drives now called volumes. The default view is now a logical one for creating 
volumes; partitions are created during volume creation if necessary. More 
control of the partitioning can be obtained by changing the view from logical 
to physical; function key [F5] can be used to alternate between views. The 
physical view provides the same functionality as FDISK did. 

LVM.EXE also provides the capability to exploit new features of the 
underlying logical volume management system. The main enhancements are 
the linked volumes and sticky drive letters. A new type of volume called LVM 
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allows the linking of several partitions from possibly several disks. The LVM 
volume is presented to the system as a single drive. A drive letter can be 
assigned to either a new LVM volume or an older compatibility volume. This 
assignment persists until changed by the user. 

LVM is available as command line VIO and GUI (LVMGUI.CMD) and provides 
the following functionality: 

• Create Compatibility Volumes (partitions) that can be seen by Pre-LVM 
releases of OS/2. 

• Create Logical Volumes which span physical disks. 

• Expand Logical Volumes (for JFS only). 

• Delete Logical Volumes. 

• Delete Compatibility Volumes. 

Figure 38 on page 104 and Figure 40 on page 105 show the Logical and 
physical views of LVM respectively. Figure 39 on page 105 and Figure 41 on 
page 106 show the Logical and physical views of LVMGUI, which is the 
graphical user interface (GUI) replacement for FDISKPM. 




Figure 38. Physical view via LVM. EXE 
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♦ 



DISKI 
8205 MB 



4204 MB 



F: 

1998 MB 



Volume Name Partition Name 


Status File System Size(MB) 


Type 


[BOOT MANAGER] 


Startable Boot Manager 7 


Primary 



Figure 39. Physical view via LVMGUI.CMD 




Figure 40. Logical view via LVM.EXE 
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Figure 41. Logical view via LVMIGUI.CMD 



The syntax associated with the LVM.EXE utility has been redesigned from 
FDISK to utilize the new functionality being offered by LVM. This functionality 
is also reflected in the command line interface. The new command line 
interface syntax is summarized below, and its optional parameters are 
summarized by Table 8 and Figure 43 through Figure 45. 





LV IVI 


command line parameters 









Figure 42. LVM command syntax 



Note 

You can only have one command_line_parameter if the /FILE option is used. 



Table 8. Configuration variables for LVM 



Parameters for LVM.exe 



Command line parameters 



Option 



Parameters 



Description 
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Parameters for LVM.exe 


/FILE: 


<file_name> 


Response file with LVM commands. 


/QUERY: 


<Query_Parameters> 


Query configuration. 


/CREATE: 


<Creation_Parameters> 


Create a volume or Partition. 


/DELETE: 


<Deletion_Parameters> 


Delete volumes or Partitions. 


/HIDE 


<volume_name> 


Hide from OS/2. 


/BOOTMGR: 


physical drive number e.g. 1 
[This can only be 1 or 2] 


Install the boot manager on the specified 
physical drive. 


/SETNAME: 


<Name_Chg_Parameters> 


Set volume, partition, or disk name. 


/SETSTARTABLE: 


<Setstartable_Parameters> 


Set the startable flag on primary partitions or 
bootable volumes. 


/NEWMBR 


<drive_number> 


Write a new Master Boot Record. 


/EXPAND 


<Expand_Parameters> 


Expand a JFS volume. 
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Query_Parameters- 



■ PRIMARY - 



-LOGICAL - 



I , optional_query_parameters 






I , optional_query_parameters 






-FREESPACE 



I , optional_query_parameters 






-USUABLE - 
-VOLUMES | 

-COMPATIBILITY 

-LVM j- 

-ALL 



| , optional_query_parameters — T 

, optional_query_parameters — I 

, optional_query_parameters — 



optional_query_parameters 






optional_query_parameters 






BOOTABLE 






- drive_number — ( 
I — drive_name — 

' — ALL 



Optional_Query_Parameters - 



VJI 1 Vt 1 IUI 1 1 1 






drive_name 




— filesystemjype— 


ALL 


I 



Figure 43. LVM parameter options (1 of 3) 
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Creation Parameters 



PARTITION 
VOLUME - 



, Partition_Parameters 
, Volume_Parameters ■ 



Partition_Parameters 



partition_name 






, drive_number 
, drive_name — 



size — | 



t~, LOGICAL—i 


r , BOOTABLE 


PRIMARY J 


- , NONBOOTABLE — 
— , NOTBOOTABLE — 



, BESTFIT 

, FIRSTFIT 

, LASTFIT 

, FROM LARGEST — 

, FROMSMALLEST - 

, free_space_id 



— , FROMSTART — I 
1 — , FROMEND 1 



Volume_Parameters COMPATIBILITY 



i— , BOOTDOS - 


drivejetter 


— , BOOTOS2 — 




— , NOBOOT — 





. , volume_name — , partition_list_parameters - 



I— LVM-, drivejetter — , volume_name 



L, partition_list_parameters ^ 



Partition_List_Parameters 



1 — drive_number 
— drive_name — 



, partition_name 



Figure 44. LVM parameter options (2 of 3) 
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Deletion„Parameters- 



-ALL 



t — , VOLUMES 

, UNUSED 

, COMPATIBILITY 

, LVM 



— , PRIMARY 
, LOGICAL 



— PARTITION 



drive number 



drive_name 



' — 



partition_name- 



— VOLUME , volume_name 



Expand_Parameters 



volume_name 



- , partition_list_parameters - 



Name_Chg_Parameters 



VOLUME , volume_name — , new_volume_name - 

X , Ul IVC MUIMUC7I i 

, drive_name — I 

I— DRIVE , drive_name , new_drive_name - 



|— PARTITION -p , drive_number — , partition_name— , new_partition_name- 
, drive_name- 



Setstartable_Parameters ■ 



PARTITION ■ 






drive_number 
drive_name - 



, partition_number 



1 — VOLUME , volume_name 



Figure 45. LVM parameter options (3 of 3) 
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As an example, the LVM syntax will be used to create the partitioning shown 
in Figure 46 on page 111. 




Figure 46. Partitioning used in the CID environment 



f ' 

lvm /delete : all , volumes 

lvm /delete : all , unused 

lvm /delete : all , primary 

lvm /delete : all , lvm 

lvm /delete : all , logical 

lvm /delete : all , compatibility 

lvm /bootmgr : 1 

lvm /create : part it ion , SoS , 1 , 32 , primary , bootable 

lvm /create : volume, compatibility , bootos2 , c : , SoS , 1 , SoS 

lvm /create : part it ion , system, 1,512, logical, boot able 

lvm /create : volume, compat ibility , bootos2 , d : , system, 1 , system 

lvm /create :partition , dump , 1 , 129 , logical , nonbootable, [ FS1 ] , fromstart 

lvm /create : volume, compatibility, noboot , e : , dump , 1 , dump 

lvm /create :partition , data, 1 ,, logical , nonbootable , [ FS1 ], fromstart 

lvm /create : volume, lvm, f : , data , 1 , data 

— 

Figure 47. LVM command line commands to partition the disk 

The commands listed in Figure 47 are described as follows: 

• Lines 1-6 delete any existing partitions. 

• Line 7 creates the boot manager partition. 
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• Line 8 creates the SoS partition, and Line 9 creates the volume within 
this partition. 

• Line 10 creates the system partition, and Line 11 creates the volume 
within this partition. 

• Line 12 creates the dump partition, and Line 13 creates the volume 
within this partition. 

• Line 1 4 creates the data partition, and Line 1 5 creates the volume within 
this partition. 

4. 2. 4. 5 Bad Block Relocation (BBR) Alarm Utility 

The BBR Alarm Utility provides an indication that bad blocks have been 
encountered and that BBR is happening in some of the accesses to the hard 
disk, thus, indicating potential hard disk performance degradation and/or 
potential hard disk failure. 

4.2.5 Bad-block relocation 

Bad Block Relocation (BBR) allows bad sectors that are discovered after 
initial burn-in (and hardware recording/relocation) of the drive to be remapped 
via software. It allows a good sector (replacement sectors are reserved on 
the disk) to be transparently substituted to an application for the bad sectors 
discovered during write operations on the disk. 

4.2.6 LVM operation 

LVM can only work with partitions types it can understand; these are LVM- 
and LVM-compatible volumes. Hence, the first time OS/2 Warp Server for 
e-business is installed on a pre-partitioned hard disk, VCU (Volume 
Conversion Utility) runs. Its function is to detect existing partitions that it 
understands and convert them into LVM Compatibility volumes. Compatibility 
volumes are special volumes that are compatible with previous versions of 
OS/2 or other operating systems. A compatibility volume corresponds to a 
single physical partition and can be made bootable. Each compatibility 
volume can exist on only one physical hard drive; they do not support 
dynamic expansion. 

OS2LVM helps handle requests for data blocks to be written (or read) from 
IFSM by providing a mapping from the new logical sector number (LSN) disk 
addressing to the actual physical partition sector number (PSN) addressing 
used by OS2DASD and by the adapter device drivers (ADDs) to access the 
disks. OS2LVM also provides mapping of contiguous LSN addressing to 
discontinuous PSN addressing when spanning physical disks for a logical 
volume. 
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The interaction between OS2LVM and OS2DASD in detecting DASD can be 
summarized as follows: 

• At boot time, the device drivers locate the devices attached to the system. 
The storage devices report their findings to OS2DASD. 

• OS2DASD examines the storage devices found for partitions. 

• OS2DASD creates a table with an entry for each partition it has found. 

• OS2DASD passes this table of partitions to the OS2LVM. 

• OS2LVM filters the table adding and removing entries as required. It then 
adds the drive letters found in the LVM data taken from the drives and 
passes the table to the IFSM. 

• IFSM uses the drive letters placed in the table by OS2LVM. 

4. 2. 6.1 LVM GUI 

The partitions and volumes can also be managed by using the Logical 
Volume Manager (LVM) GUI. The LVM GUI icon can be found in the SYSTEM 
SETUP folder. 

The LVM GUI provides two views: 

1 . The Logical view 

2. The physical view 

The Logical view 

The logical view displays information about the volumes. It displays the list of 
all volumes that have been created and information regarding each volume. 
The information includes the drive letter assigned to the volume, the name of 
the volume whether the volume is bootable or non-bootable, the file system 
used, the size in MB of the volume, the percentage of the used space and 
free space on the volume, and the type of volume, such as compatible or 
LVM. 

It allows the user to perform volume management functions. It allows the user 
to create, delete, rename, expand, and hide volumes. The user can also 
install or remove Boot Manager. 

The View menu option allows the user to shift between views. 

Physical view 

The LVM physical view displays the disk information. The upper half of the 
screen contains the information about the partitions and the lower half of the 
screen contains information about the volumes. The partition window displays 
information about how the disks in the system are partitioned. It displays 
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information about the partition size and the file system used. The volume 
window on the lower half of the screen provides information about the 
volumes and the partitions assigned to them. The LVM physical view allows 
the user to create and manage partitions. 

4. 2. 6. 2 Volume management 

A logical volume is a single partition on a hard disk or a collection of partitions 
spanning multiple hard disks that are presented to a user as a single entity. 
The user views a volume as a single logical partition even though a volume 
might be comprised of one or more physical partitions. The user views and 
accesses this volume using a drive letter. LVM allows the user to create and 
manage volumes and partitions. It has to be noted that drive letters are 
assigned to volumes and not partitions. 

Note 

When you create a partition, the new partition has to be assigned to a 
volume. Either a new volume has to be created and the partition assigned 
to the volume or an existing volume can be expanded to include the new 
partition if the volume is a JFS volume. You cannot use a partition without 
having it included in a Volume. 

Some of the definitions the LVM user needs to be familiar with are explained 
below: 

Volume Name This is the name assigned to the volume by the user. 

Drive letter A drive letter is assigned by the user to the volume at its 
creation time. This drive letter is used by the user to view 
and access information on the volume. 

Status This reflects the volume designation. Four types of volume 

designation are possible: 

Bootable This is the volume designation used by the LVM 

indicating that the volume contains the bootable 
operating system. When a bootable volume is created, 
it is automatically added to the Boot Manager menu. 
For example, if you have two operating systems 
installed in two different volumes, you can designate 
each volume as bootable. Bootable volumes exist only 
when Boot Manager is present; otherwise, the bootable 
volume is designated as startable. 

Installable This is a volume designation used by LVM during 

installation indicating that the OS/2 Warp for 
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e-business will be installed on that volume. Only one 
volume can be set as installable. The installable 
designation is displayed and set only during installation 
and it implies that the installable volume is also 
Bootable or Startable depending on whether Boot 
Manager is installed. If Boot Manager is installed, the 
volume that is set Installable is also Bootable. If Boot 
Manager is not installed, the volume that is set as 
Installable is also startable. 

Nonbootable This is the volume designation used by the LVM 
indicating that the volume is not set bootable. For 
example, you might have an operating system installed 
in one volume and you might save your data in another 
volume. 

Startable This is a volume designation used by the LVM 

indicating the volume that is used when the system 
starts. A startable volume must contain either the Boot 
Manager or a bootable operating system. If Boot 
Manager is installed, it is automatically set as a 
Startable volume and the Boot Manager menu is 
displayed when the system starts. If Boot Manager is 
not installed, you must set as startable a volume that 
contains an operating system. Only one volume can be 
set as Startable. A Startable volume is the primary 
partition that is used to start the system by virtue of 
being the active partition. If any volume other than the 
Boot Manager partition is set startable, no volume is 
displayed as bootable, and the Boot Manager will not 
run. Boot Manager is typically set as the Startable 
volume but is not displayed in the Logical view. 

File system This indicates the type of file system used on the volume. 

Two types of volumes are possible with LVM: 

Compatibility Volumes These volumes can be marked as bootable or 

startable, are accessible by other operating 
systems, and can be formatted for 386HPFS, HPFS, 
and FAT. It cannot be formatted for JFS. The OS/2 
base operating system must be installed on a 
compatibility volume. These volumes can have only 
one partition. 
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LVM Volumes 



These volumes can be formatted for 386 HPFS, 
HPFS, FAT, or JFS. A single volume can contain 
multiple partitions. LVM volumes can be accessed 
only by OS/2 versions that contain LVM. The LVM 
volumes cannot be set as bootable. 

Logical Volume Manager allows the following operations on a volume: 

• Creating a New Volume 

• Deleting a Volume 

• Expanding a Volume 

• Changing the Drive Letter of a Volume 

• Eliding the Volume 

• Changing the Name of the Volume 

• Setting the Type of the Volume 

Creating a new volume 

A new volume can be created using the LVM GUI: 

1 . Enter the Logical Volume View. This can be done by selecting the Logical 
volume view entry from the View menu option. 

2. Select the Volume menu option. Click on the Create Volume entry. Select 
the Create Bootable option or the Create non-bootable volume. If it is a 
non-bootable volume, select the type of the volume: Compatibility or LVM 
volume. 

Note 

A single LVM volume can be comprised of multiple partitions, while a single 
Compatibility volume can only have a single partition. If you are creating a 
Compatibility volume, you are allowed to select only one partition from the 
partition list. If you are creating an LVM volume, you are allowed to select 
multiple partitions. 



If you have a CD-ROM drive, it will be assigned a drive letter. When you are 
creating a new volume, this drive letter is also displayed. If you assign this 
drive letter to the new volume, you will have to reboot the system when you 
are finished. 

Deleting a volume 

• Select the Logical Volume View from the View menu option. 

• Click on the Volume menu option 

• Select the Delete Volume entry, which displays the list of volume names 
configured in the system. Select the volume that has to be deleted. 
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Expanding a volume 

You may expand the volume if the volume does not have a file system 
associated with it (if it is unformatted) or if the volume has JFS associated 
with it. If the file systems other than JFS are associated with it, you must first 
delete it and then re-create it. 

• Select the Volume menu option. 

• Select the Expand Volume entry. This displays the list of the volumes 
configured in the system 

• Select the volume that is to be expanded 

• A window appears that displays the free space and partitions. If a partition 
is available and you wish to use that to expand the volume, select that 
partition or select freespace. 

• Choose OK to expand the volume. 

Changing the drive letter of a volume 

• Select the Volume menu option from the Logical Volume View 

• Select the Set/change drive letter entry. This displays the list of the 
volume names configured in the system. Select the volume that has to be 
changed. A warning message appears. Read the warning message 
carefully. Press OK to proceed. 

• A window is displayed with the list of drive letters. Select the new drive 
letter and press OK. 

Changing the name of the volume 

Select the Volume menu option 

• Select the Set/Change name on volume entry. This displays the list of 
volume names configured in the system. Select the volume that has to be 
changed. 

• Enter the new name of the volume in the window displayed. Choose OK to 
assign the new name to the volume. 

Hiding a volume from OS/2 

This option is used to make the volume invisible to OS/2, that is, to block 
access to a volume by the file system. For example, if you have a Windows 
volume, you might not want to access it from OS/2. Therefore, you need to 
hide the volume. A volume that is hidden is no longer accessible by OS/2, but 
all the associated data still exists on the hard disk. 

• Select the Volume menu option from the Logical Volume view. 
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• Select the Hide volume from OS/2 entry, which displays the list of 
volumes. 

• Select the volume that has to be hidden. 

Setting a volume startable 

Select Set the volume startable to set the selected volume startable. A 
startable volume is a volume that is used to start the system from the hard 
disk. It is the active partition. Only a compatibility volume on a primary 
partition can be set startable with LVM. Boot manager, if it is installed, is 
automatically set as the startable partition. Only one partition can be set as 
startable; therefore, if Boot Manager is to be active, no volumes can be set as 
startable. If you set a volume startable with LVM, Boot Manager is disabled. 
Note that Boot Manager cannot be seen from the LVM logical view because 
no drive letter is assigned to it, but it can be seen in the LVM physical view. 

Setting a volume installable: 

A volume can be set installable only during installation of OS/2 Warp Server 
for e-business. The volume on which the OS/2 Warp Server is to be installed 
is designated as Installable during the installation of OS/2 Warp Server for 
e-business. 

4. 2. 6. 3 Boot Manager 

When you have multiple primary partitions and different operating systems on 
these partitions, the system has to be told what operating system to boot from 
at system startup time. Boot Managers are used for this purpose. Boot 
Manager is a program that normally inserts itself into the very beginning of 
the boot process by setting up a boot manager partition and making itself the 
active partition. When the system is started, the Boot Manager runs and 
analyzes the partitions and presents a menu. This menu lists all the bootable 
operating system volumes. The user can then select the desired operating 
system. Control is then transferred to the boot code on that partition and the 
operating system loaded. 

Installing Boot Manager 

Select Install Boot Manager from the Boot Manager menu to install boot 
manager on the system. Boot Manager is automatically set as the startable 
partition. Since only one partition can be Startable, if Boot Manager is 
installed, no other volumes can be designated as Startable. Boot Manager is 
installed as a new primary partition at the beginning of the first free space 
block where a new primary partition is allowed. This partition is the smallest 
allowed, typically, from 1 MB to 1 0 MB depending on the size of the hard disk. 
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Removing Boot Manager 

Select Install Boot Manager from the Boot Manager menu to remove the 
boot manager. 

Note 

Once the Boot Manager is removed, one of the volumes must be set as 
startable; otherwise, it will not be possible to boot from the hard disk. 



Adding a volume to the Boot Manager menu 

Select Add the volume to Boot Manager to add a volume to the Boot 
Manager menu. Only bootable volumes are displayed. 

Removing a volume from the Boot Manager menu 

Select Remove volume from Boot Manager to remove the volume from the 
Boot Manager menu. 

Setting or Changing the Boot Manager startup values 

Boot Manager startup values are used to set the default boot volume, set the 
timer inactive, change the timeout value, and change the display mode. The 
following options are available: 

• Default Boot Selection: This allows you to choose the default boot volume 
that boots automatically each time you start the system unless you select 
another volume from the Boot Manager menu. 

• Timer Active: This toggles between YES or NO. Select YES when you 
want the default volume to boot automatically after the timeout period. 
Select NO to specify that the startup menu is to remain displayed until a 
selection is made. 

• Time-out: This value specifies the number of seconds the Boot Manager 
waits before the default volume is booted automatically. This value is 
active only when Timer Active is Yes. 

• Display Mode: Normal mode displays only the names of the volumes on 
the startup menu. Advanced mode gives more information about the 
volumes on the startup menu. This information includes disk number, drive 
letter, type of partition, volume size, file system type, and accessibility if 
hidden. 

4. 2. 6. 4 Partition management 

The LVM physical view displays the partitions present on each hard disk 
allowing you to create and manage individual partitions. You can create 
partitions for other operating systems that do not recognize the LVM volumes. 
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You can create a partition of a specific size and allocate it from the beginning 
or end of the free space. 

Note 

Drive letters are assigned only to Volumes and not partitions. When you 
create a partition or you want to use a previously created partition, you 
have to create a volume that can contain this partition. When you create a 
volume, a drive letter is assigned to it. You cannot create a partition and 
use it without assigning it to a volume. See the Volume Management 
section for information about volumes. 



Creating a partition 

• Select the Partition menu option from the physical view. 

• The Create partition window is displayed. Select the partition location. 

• Select the type of partition: Primary or Logical. 

• Select the disk on which the partition has to be created. Specify the size of 
the partition and the name of the partition. 

• Choose OK to create the new partition. 

Deleting a partition 

Select the Partition menu option from the physical view. 

• Select the Delete Partition entry. 

• A window lists all the existing partitions. 

• Select the partition that has to be deleted. 

• Choose OK to delete the partition. 

Note 

After volumes have been created with LVM, FDISK should no longer be 
used to manage partitions. 



4.2.7 Logical volume manager benefits 

The Logical Volume Manager provides the following enhancements: 

• It provides a single interface for configuring both physical and logical 
volumes. 

• Bad Block Relocation (BBR) is provided for JFS; HPFS provides its 
own BBR. This improves reliability and availability. 
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• It allows a JFS volume to span physical disks providing volumes up to 
2 Terabytes in size. 

• It allows partitioning to be done dynamically without having the need to 
reboot. The LVM has been designed to allow both expansion and 
reduction of volumes; however, only expansion has been implemented 
in this release. 

• Performance in the I/O path is improved by using 32-bit data and 
instructions to support the 32-bit I/O path for JFS. 

• There are Dynamic/Sticky drive letter assignments regardless of any 
other system changes. 



4.3 Journaled file system 

The Journaled File system is an installable file system (IFS) that was built on 
IBM AIX JFS technology; however, the disk-image layout differs due to the 
feature set of the file system unique to OS/2. 

JFS is intended as a replacement for the High Performance File System 
(HPFS). One of the shortcomings of HPFS is the amount of time required to 
recover from a system crash on large hard drives. JFS overcomes this by 
providing a robust, quickly-restartable, transaction-oriented, log-based, 
high-performance, 32 bit file system for OS/2. It is primarily tailored for the 
high throughput and reliability requirements of modern servers especially in 
the TCP/IP environment. 

4.3.1 JFS cache 

In most cases, applications requesting data that resides on JFS formatted 
partitions will receive the data from JFS cache. JFS cache, like HFPS, FAT, 
and HPFS386 cache is initialized on startup. JFS cache is configured and 
initialized by the IFS statement in the CONFIG.SYS. 

All buffer cache I/O is performed through explicit I/O requests to the 
underlying DASD device driver using the strat3 interface shown in Figure 37 
on page 103. The buffer cache resides in pinned memory and is shared by all 
mounted JFS file systems. 

By default, the size of the JFS buffer cache will be12.5 percent of the size of 
real memory. Not all file system I/O will be performed through the buffer 
cache since the JFS supports the NOCACHE advisory file open mode. When 
this function has been requested for a file, the JFS will perform I/O directly 
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between user buffers and the underlying device when processing read and 
write operations on the file. 



To configure the JFS, an IFS= statement must be added to CONFIG.SYS. 
This statement is described below. 



IFS= Statement 

IFS=pathname [/CACHE:<size in kilobytes>] [/AUTOCHECK:drive[drive...] 
/[L:OFFI/L:synctime,maxage,bufferidle]] 

Example: IFS=C:\OS2\JFS.IFS /AUTOCHECK:* /CACHE:1024 



Figure 48. Syntax for JFS initialization 



Table 9. JFS initialization parameters 



Parameter 


Description 


pathname 


Specifies that pathname of the JFS IFS. 


/CACFlExsize in kilobytes> 


Specifies the size of the JFS buffer cache in 
Kilobytes. By default, this size is set to 12.5 
percent of real memory. 


/AUTOCHECK:drive[drive...] 


Specifies a list of JFS file systems, identified 
by driver letter, to be included in automatic 
recovery by CHKDSK at the time of JFS 
initialization. If an asterisk (*) is specified 
instead of a drive letter list, all JFS file 
systems will be included in automatic 
recovery during JFS initialization. If any drive 
letter is preceded by an arithmetic plus sign 
(+), CFIKDSK will perform a full integrity 
check on the drive even if journal log replay 
has restored the drive to an apparently 
consistent state. If the list of drive letters ends 
with plus-asterisk (+*), CFIKDSK will perform 
a full integrity check on all JFS file systems 
not specified in the list even if journal log 
replay has restored them to an apparently 
consistent state. 


/L:OFF 


Specifies the lazy write parameters in 
seconds. OFF forces all to be synchronous. 
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Parameter 


Description 


/L:<synctime,maxage,bufferi 

dle> 


Synchtime is the interval at which the sync 
thread runs, default is 32. Maxage is the 
longest time that a modified file is kept in 
cache, default is synchtime*4. Bufferidle is 
the time indicating a "recent" change. 
Changes newer than this value are not 
written unless the last write was older than 
maxage, default is Mln(1, synchtime/8). 



4.3.2 JFS structure 

The Journaled File System is implemented through a set of operating system 
commands that allow the creation, management, and deletion of files. Special 
32-bit extensions have been added to optimize JFS performance. A JFS is 
created inside a logical volume and is organized as shown in Figure 32 on 
page 97. To enable JFS support, you first need to create a volume using LVM, 
which is a non-bootable LVM volume. Within this, you can install JFS support. 

In JFS, data storage space is organized in three levels: files (and directories), 
filesets, and aggregates. The file is a unit of user data. Files are organized in 
a hierarchical directory structure. The directories themselves are located in 
filesets. The filesets reside on aggregates. A fileset is a collection of 
directories and files managed as a single unit. The aggregate is the unit of 
disk storage that contains one or more filesets; initially, only one fileset per 
aggregrate is implemented in the initial release of JFS. Filesets can vary in 
size but cannot be larger than the housing aggregrate. The concept of an 
aggregrate has been introduced to support the Distributed Computing 
Environment Distributed File System (DCE DFS). 

When a new aggregate is created, it gets registered with the LVM as a logical 
volume. 

4.3.3 JFS disk layout 

JFS divides the Logical Volume (also known as a disk partition) into a number 
of fixed-size units or logical blocks. An aggregate has an array of disk blocks 
with specific formats that include a superblock and an allocation map. The 
superblock identifies the Logical Volume as a JFS aggregate while the 
allocation map describes the allocation state of each data block within the 
aggregate. The format also includes the initial fileset and the control 
structures necessary to describe it. The fileset is a mountable entity 
containing files and directories. Files and directories are represented 



Journaled file system and logical volume manager 1 23 





persistently by inodes; each inode describes the attributes of the file or 
directory and serves as the starting point for finding the file or directory’s data 
on the disk. JFS also uses inodes to represent other file system objects, such 
as the map which describes the allocation state and location on disk of each 
inode in the fileset. Extent-based addressing structures rooted in the inode 
are used for mapping file data to disk. 

In addition to files, user data may exist in the form of extended attributes that 
allow applications to attach named data to the file or directory. Extended 
attributes are stored separately from file data or directory entries and are 
maintained through the associated inode. 

Together, the aggregate superblock and disk allocation map, fileset descriptor 
and inode map, inodes, and addressing structures represent the JFS control 
structures or meta-data. 

JFS logs are maintained in each aggregate and used to record information 
about operations on meta-data. JFS uses techniques originally developed for 
databases to log information about operations on the file system meta-data 
as atomic transactions. In the event of a system failure, a file system is 
restored to a consistent state by replaying the log and applying log records 
for the appropriate transactions. Flowever, JFS only logs operations on the 
meta-data; so, replaying the log only restores the consistency of the 
structural relationships and resource allocation states within the file system. It 
does not log data or recover this data to a consistent state. Consequently, 
some data may be lost if stale after recovery; thus, users with a critical need 
for data consistency should use synchronous I/O. JFS does not log the 
extended attributes; instead, it replaces the old version with the new version 
as an atomic operation. 

4.3.4 JFS system structure 

This section describes the major aspects of the JFS on-disk layout. It 
describes the extent-based file geometry, directory formats, the formats of 
block allocation maps, inodes, and so on. 

JFS uses extent-based addressing structures and aggregate block allocation 
policies to produce compact, efficient, and scalable structures for mapping 
logical offsets within files to physical address on disk. An extent is a 
sequence of continuous blocks allocated to a file as a unit and is described by 
a triple consisting of clogical offset, length, physical address>. The 
addressing structure is a B + -tree populated with descriptors (the triples 
above), rooted in the inode, and keyed by the logical offset within the file. 
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Thus, a file can be viewed as being allocated in a sequence of extents where 
each extent defines a contiguous variable-length sequence of aggregate 
blocks allocated as a unit. An extent can range in size from 1 to 2 24 -1 
aggregate blocks. Therefore, the size of the maximum extent depends on the 
aggregate block size. With a 512 byte aggregate block size (the smallest 
allowable), the maximum extent is 512*(2 24 -1)bytes (almost 8GB). With a 
4096 byte aggregate block size, the maximum extent is 5096*(2 24 -1)bytes 
(almost 64GB). These limits only apply to a single extent; it does not have 
any effect on limiting the overall file sizes. With smaller size extents, there is 
less internal fragmentation for aggregates with large numbers of small-size 
files. 

In general, the allocation policy for JFS tries to maximize contiguous 
allocation by allocating a minimum number of extents, with each extent as 
large and contiguous as possible. This results in larger I/O transfer, which 
results in improved performance. 

Fragmentation can still occur, and, for this reason, a defragmentation utility, 
defragfs, is provided to reduce fragmentation in the internal data structure, 
which occurs from the dynamic allocation/deallocation of variable size 
extents. The allocation/deallocation results in disconnected variable size 
extents all over the aggregate. The defragmentation utility coalesces small 
free extents into single larger extents. 

JFS divides the Logical Volume into a number of fixed size units or logical 
blocks. Each logical block comprises a fixed number of aggregate blocks, 
which can be 512, 1024, 2048, or 4096 bytes. The aggregate block size is 
defined at creation time via extra parameters to the format command, which 
defines the smallest unit of space allocation supported on the aggregate. 
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Figure 49. JFS physical organization in a logical volume. 

The logical blocks in the file system are comprised of: 

Reserved Block 0 



This logical block is reserved and largely unused. Its origins is from the AIX 
implementation of JFS; if it is at the start of the disk, 1 K is used for the 
bootstrap program. LVM data is also stored in this block. The LVM data 
resides just before the bootstrap area. 
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Superblock 

The first and fourth logical blocks are reserved for the superblock, with the 
fourth block being a backup copy of the first. The superblock contains 
information, such as the aggregrate size, the file system name, version 
number, and file system state. 

Allocation groups 

The rest of the logical blocks are divided into a number of allocation groups. 
Allocation groups are comprised of data blocks and i-nodes, which reference 
these data blocks. Allocation groups allow resource policies to be applied, 
which results in good I/O performance. The purpose of these allocation 
policies is as follows: 

• To improve locality of reference 

Files created within a directory will be maintained in an allocation group 
with that directory. The policy tries to allocate contiguous logical blocks, 
clustering together disk blocks and disk i-nodes of related data to achieve 
good locality for the disk. This results in less disk head movement, thus, 
quick access to the data. 

• To ease file system extension 

Extending the file system is easier because a new allocation group of 
i-nodes and data blocks can be added maintaining the relationship 
between i-nodes and file system size simply. Without allocation groups, 
the file system would either have to be reorganized to increase the 
number of i-nodes, or, the extension could only increase the number of 
data blocks available, thereby, conceivably, limiting the number of files 
and directories in the file system. 

In order to minimize the number of updates required when an aggregate is 
expanded (or shrunk), the allocation groups have been limited to a maximum 
number of groups, 128. Additionally a minimum of 8192 aggregate blocks has 
been imposed in the size of the allocation group. 

I-nodes 

Basically an i-node is a pointer to a file. An i-node contains information on the 
file, such as the type of file, the size in bytes, permissions, owner, access 
permissions for the file, the number of blocks allocated to the file, creation 
date, last modification date, last accessed date, and pointers to the blocks 
that actually contain the file. 
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Inodes are allocated dynamically by allocating inode extents that are simply a 
contiguous chunk of inodes on the disk. By definition, a JFS inode extent 
contains 32 inodes. With a 512 byte inode size, an inode extent is, therefore, 
16 KB in size on the disk. 

Information within an i-node is divided into two parts. The first part contains 
information, such as permissions and owner for the directories or file. The 
second part contains an array of pointers to the actual disk addresses of the 
logical blocks that make up the file or directory. 

The extent is represented on the aggregrate disk structure by an extent 
allocation descriptor (xad) structure. The xad structure is as follows: 



struct xad { 

unit 8 xad_flag; 
unitl6 xad_reserved; 
unit 40 xad_offset; 
unit 2 4 xad_length; 
unit40 xad_address; 

}; 

) 

where: 

xad_fiag is an 8-bit field containing miscellaneous flags. These flags can 
indicate copy-on-write for DFS if the extent is allocated but not 
recorded for databases, information for compression, help for 
journaling, and so on. 

xad_reserved is a 16-bit field reserved for future use. It is always zero. 

xad_offset is a 40-bit field containing the logical offset of the first block in 
the extent. The logical offset is represented in units of the 
aggregate block size, that is, to get a byte offset, xad_offset must 
be a multiplied by the aggregate block size. 

xadjLength is a 24-bit field containing the length of the extent. The length 
is represented in units of aggregate block size. 

xad_address is a 40-bit field containing the address of the extent. The 
address is represented in units of the aggregate block size. 

Files that can fit within the array storage area, such as most links, are actually 

stored in the i-node itself, thus, saving space. 
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The following four examples illustrate the use of the extent descriptors in file 
representation in the aggregate. In the examples below, the aggregate block 
size is 1 KB. 

• A 1041377 byte file allocated contiguously: 

This file requires 1017 1KB aggregate blocks (with 31 bytes in the last 
aggregate block lost to internal fragmentation). Only one xad structure is 
required to describe this contiguous file: 



xad_flag 


<not discussed here> 




xad_offset 


0 


/* the beginning of the file 7 


xadjength 


1017 


/* 1017 1KB aggregate blocks 7 


xad_address 


nnnnn 


/* aggregate block # 7 



— Note 

This same xad structure could be used to represent any contiguous file 
of size 1040385 (1016*1024+1) to 1041408 (1017*1024), because 
extent descriptors only represent sizes down to aggregate block size 
granularity. 

• A 1041377 byte file allocated in three pieces: 

Assuming the above file is split into three separate extents on the disk: 
One 495 aggregate blocks long, one 22 blocks long, and one 500 blocks 
long. It requires three xad structures to represent this file - one per 
physical extent. 

xad # 0 



xad_flag 


<not discussed here> 




xad_offset 


0 


/* the beginning of the file 7 


xadjength 


495 


/* 495 1 KB aggregate blocks 7 


xad_address 


nnnnn 


/* aggregate block # 7 
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xad # 1 



xad_flag 


<not discussed here> 




xad_offset 


495 


/* bytes starting at #506880 7 


xadjength 


22 


/* 22 1 KB aggregate blocks 7 


xad_address 


mmmmm 


/* aggregate block # 7 



xad # 2 



xad_flag 


<not discussed here> 




xad_offset 


517 


/* bytes starting at #529408 7 


xadjength 


500 


/* 500 1 KB aggregate blocks 7 


xad_address 


JJJJJ 


/* aggregate block # 7 



In this case, xad # 0 describes the first 495 physical aggregate blocks of 
the file. The xad_offset field contains zero because this xad describes the 
bytes starting at logical offset zero. Next, xad # 1 describes the next 22 
physical aggregate blocks of the file. The xad_offset field contains 495 
because this xad describes the bytes starting at logical offset 506880 
(495*1024); the previous bytes being described by xad 0. The final xad 
describes the last 500 blocks of the file. The xad_offset field here is 517. 
Notice, that for files which are not sparse, the xad_offset field of a given 
xad is equal to the sum of the lengths of the previous xad structures 
(517=495+22) for this example. 

• 1041377 byte sparse file: 

For this example the file has two bytes of data starting at logical byte 
offset zero, and three more bytes starting at logical byte offset 1,041,374, 
and has all zero (sparse) in between. The file is 1041377 bytes long. The 
volume has been formatted for sparse files by using the /s option when 
formatting. 

When formatted sparse JFS does not allocate physical disk space to hold 
byte ranges of a file that has never been written to. Therefore it will take 
two xad structures to represent this file, one for the first two bytes and one 
for the last three bytes of data. 
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xad # 0 



xad_flag 


<not discussed here> 




xad_offset 


0 


/* the beginning of the file 7 


xadjength 


1 


/* 1 1KB aggregate blocks 7 


xad_address 


nnnnn 


/* aggregate block # 7 


ad # 1 


xad_flag 


<not discussed here> 




xad_offset 


1016 


/* bytes starting at # 10403847 


xadjength 


1 


/* 1 1KB aggregate blocks 7 


xad_address 


nnnnn 


/* aggregate block # 7 



In this case, the first extent (xad 0) contains two bytes of data and 1022 
bytes of zero. The last extent (xad 1) contains 990 bytes of zero followed 
by 3 bytes of data. The remaining 31 bytes in the 1 KB extent are not part 
of the file. 

Note that, in this case, the xad_offset fields are necessary because they 
are the only way to know that xad 1 represents a sequence of bytes that 
are at an unexpected logical offset within the file. That is, the offset for xad 
1 does not equal the offset of xad 0 + length. This is how a sparse file is 
represented. 

• 16GB file allocated contiguously: 

The length field in an xad structure is only 24 bits long; therefore, it can 
hold a value up to 2 24 -1 . With an aggregate block size of 1 KB, the longest 
extent a single xad can represent is (2 24 -1)*2 10 = 1KB less than 16 GB. 
By implication, this is also the largest extent a single xad structure can 
represent. Thus, if a file is large enough, it will require multiple xad 
structures to represent it, even if the file is contiguous on the disk. Thus, 
the continuously allocated 16GB file starting at aggregate block number 
12345 and going for 16777216 1KB aggregate blocks would be 
represented as follows: 
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xad # 0 



xadjlag 


<not discussed here> 




xad_offset 


0 


/* the beginning of the file 7 


xadjength 


1677715 


/* 16777215 1KB aggregate blocks 7 


xad_address 


12345 


/* aggregate block # 7 



xad # 1 



xadjlag 


<not discussed here> 




xad_offset 


16777215 


/* bytes starting at 1 677721 5K 7 


xadjength 


1 


/* 1 1KB aggregate blocks 7 


xad_address 


16789560 


/* aggregate block # 7 



In this case, whether or not the file is contiguous on the disk, it takes at 
least two xad structures to represent it due to the length limitation of 
individual extents. 



Generally, if a file can be represented by eight or less extents (xad 
structures), it will be stored within the inode itself as illustrated in Figure 50 on 
page 133 as direct referencing; In this case, up to eight would be direct 
references. If the number of extents required to represent the data is between 
9 and 2032 extents, indirect referencing would be used. In this case, each of 
the xad in the i-node will point to 254 leaf node (the header of the leaf node is 
32 bytes long, an xad is 1 6 bytes long, thus, the number of xad entries in a 4K 
page = (4K-32)/1 6=254). The points, in turn, point to data blocks. If the 
number of extents is > 2032 and <= 516128 allocated extents, double indirect 
referencing is used. Here, the xad in the i-node point to leaf nodes that, in 
turn, point to xad internal nodes that point to the data blocks. 
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another set of 254 points) 

Figure 50. Anatomy of an i-node 

4. 3. 4.1 In-depth look at the aggregate structure 

An aggregate has: 

• A 32K reserved data area at the front of it. 

• Primary and Secondary Aggregate Superblocks. These superblocks 
contain aggregate-wide information, such as the size of the aggregate, 
the size of the allocation groups, the aggregate block size, and so on. 
The secondary aggregate superblock is a direct copy of the primary 
aggregate superblock used if the primary becomes corrupted. These 
superblocks are at fixed locations on the disk. 

• An Aggregate Inode Table. This table contains an array of inodes 
describing the aggregate-wide control structures. This table is critical 
for finding any file system information. 
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• A Secondary InodeTable. This is a replica of the Aggregate Inode 
Table. The actual data for the inodes is not repeated, just the 
addressing structures used to find the inodes themselves. 

• An Aggregate Inode Allocation Map. This map describes the Aggregate 
Inode Table and contains allocation state information on the aggregate 
inodes as well as their on-disk location. Since the inode allocation is 
dynamic, there is not any relationship between an inode number and 
the disk address of the inode, thus, the map is required. 

• A Secondary Aggregate Inode Allocation Map. This map is a 
duplication of the Aggregate Inode Allocation Map. 

• A Block Allocation Map. This map describes the control structures for 
the allocation and deallocation of aggregate disk blocks within an 
aggregate. It tracks the allocated and freed disk blocks for the entire 
aggregate. 

• A Fileset Inode Table. This table contains an array of inodes that 
describe the fileset-wide control structures. 

• A Fileset Inode Allocation Map. This map describes the fileset Inode 
table. It contains allocation state information on the fileset inodes as 
well as their on-disk location. There is also a secondary version of this 
map that points to the same data. When the fileset is initially created, 
the first inode extent is allocated, and additional inode extents are 
allocated and deallocated dynamically as required. 

• File and Directory logical blocks. 

• fsck (chkdsk) Working Area. This area provides space for check disk to 
be able to track aggregate block allocations. This space is used when 
dealing with very large aggregate block allocations since there may not 
be sufficient memory to do the tracking. There is a one-to-one 
relationship of bit to aggregate block. The space is described by the 
superblock and is always found near the end of the aggregate just 
before the In-line log. 

• In-line Log. This space is used for logging the changes to the 
meta-data of the aggregate. This space is described by the superblock 
and is found at the end of the aggregate. 

Figure 51 on page 135 summarizes this structure and details the role of 
some of the inodes. 
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Figure 51. Aggregate details of a JFS partition. 
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4.3.5 JFS utilities 



The JFS component is made up of two pieces. The first has already been 
covered; it is the Installable File System (IFS) that provides read/write file 
access and persistent storage on local machines while supporting OS/2 file 
system semantics (that is, functional behaviors and error returns) and 
coexisting with other IFS implementations including FAT and FIPFS. Details of 
the IFS framework can be found in section 4.2.4, “Key components of the 
LVM” on page 100. The second piece is a set of utilities for creating and 
maintaining JFS at the lowest (media) level. 

The JFS support utilities have been integrated into the IFS framework to 
extend the format and chkdsk commands. Two new utilities, defragfs and 
extendfs, have also been introduced to assist in the maintenance of logical 
volumes. Defragfs defragments the file system’s free space. Extendfs 
increases the size of the file system after it has been expanded. Both of these 
new utilities are stand-alone 32-bit commands that interact with the OS/2 
kernel and underlying device driver. Figure 52 illustrates the integration of the 
JFS support utilities into the IFS framework. 




Figure 52. File system utility framework. 
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4. 3. 5.1 JFS-specific FORMAT Utility Options 

The format command has a number of additional paramotors addod to 
support JFS. 

The JFS-specific syntax for FORMAT is as follows: 

FORMAT drive [/FS:JFS] [/V:<volume label>] [/BS:<size_in_bytes>] 
[/LS:<size_in_megs>] [/S] [/L] 



Table 10. Parameters for JFS format 



Parameter 


Description 


drive 


Specifies the drive to run FORMAT on. 


/FS:JFS 


Specifies that the drive should be formatted as a JFS file 
system. 


/V:<volume label> 


Specifies the volume label. The volume label can be up to 1 1 
characters long. To include blanks in a volume label, enclose 
the label in quotation marks. If you do not specify a volume 
label, it will be set to null. 


/BS:<size_in_bytes> 


Specifies block size to use for the file system. If not specified, 
FORMAT will set the file system block size to 4096 bytes. 
The block size specified must be one of 512, 1024, 2048, or 
4096 and cannot be smaller than the device’s sector size. 


/LS:<size_in_megs> 


Specifies the size of the journaling log to create in 
megabytes. If not specified, FORMAT will create a log of 
0.4% of the file system size. 


/S 


Specifies that the file system created should support sparse 
rather than dense files. If not specified, dense file will be 
supported. 


/L 


Specifies that FORMAT should verify the disk media, that is, 
long format. 



4. 3. 5. 2 JFS-specific CHKDSK Utility Options 

The chkdsk command has a number of additional parameters to support JFS. 
The JFS-specific syntax for CFIKDSK is as follows: 

CHKDSK [/C] [/F[:{0|1|2|3}] [/V] [/B] drive 
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The following table lists the CHKDSK parameters: 

Table 1 1. Parameters for CHKDSK 



Parameters 


Description 


/C 


Perform verify/repair functions only if drive is in an 
inconsistent state. 


/F:0 


Analyze only. No write access given. 


/F: 1 or /F:2 or/F:3 or/F 


Repair all problems detected. Initiate / B processing (see 
below) after all other analysis and repair processing is 
completed and the volume is mounted. 


A/ 


Verbose messaging. 


/B 


LVM Bad Block List Processing. This is the only chkdsk 
processing which both writes to the drive and is performed 
while the file system is active. In effect, this processing 
makes bad blocks permanently unavailable so that they can 
be removed from the LVM’s bad block list, which is fixed in 
length. 


drive 


Specifies which drive to run CHKDSK on. 



Note 

If the F option is not specified then /F:0 is performed. 

Consistent with FIPFS, the V option has no actual effect on messaging. 

For chkdsk during boot processing (also known as autocheck), the /C 
and /F options should be used. This will enable log replay processing; if 
that fails, chkdsk will repair the file system. 

In addition to the options described above, the JFS chkdsk utility may 
be invoked with the undocumented debug (/d or /D) option specified. 
This option causes the chkdsk utility to process the file system as usual, 
but, in addition to being written to the JFS chkdsk service log, all log 
messages are issued to stdout in English. 



4. 3. 5. 3 JFS DEFRAGFS utility syntax 

DEFRAGFS defragments a file system’s free space. This is a description of 
the DEFRAGFS utility options. 

The syntax for DEFRAGFS is as follows: 

DEFRAGFS {[/Q]} drive 
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Table 12. Parameters for DEFRAGFS 



Parameters 


Description 


/Q 


Specifies query only. It will give the current 
file system status and perform no 
defragmentation activities. 


drive 


Specifies the drive on which to run 
DEFRAGFS. 



4. 3. 5.4 JFS EXTENDFS Utility syntax 

EXTENDFS extends the length of the file system to use the entire partition on 
which it residues. Extending the length of the file system is automatically 
taken care of. Should a reboot be necessary, this command is automatically 
placed in the CONFIG.SYS and automatically runs checking all partitions. 
Should you remove it from the CONFIG.SYS, you may need to run it 
manually. 

This is a description of the EXTENDFS utility options. 

The syntax for EXTENDFS is as follows: 

EXTENDFS [/LS:<size_in_megs>] drive 



The following table lists the parameters for EXTENDFS: 

Table 13. Parameters for EXTENDFS 



Parameters 


Description 


/LS:<sixe_in_megs> 


Specifies the (total) size of the journaling 
log to create in megabytes. If not 
specified, EXTENDFS will create a log of 
0.4 percent of the file system size. 


drive 


Specifies the drive on which to run 
EXTENDFS. 



4. 3. 5. 5 JFS-specific configuration options 

To configure JFS, an IFS= statement must be added to CONFIG.SYS. This 
section describes the syntax of this statement. 

The JFS configuration is described in Chapter 4.3.1, “JFS cache” on page 
121 . 
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4.3.6 A closer look at chkdsk 



The chkdsk utility has been enhanced for JFS volumes. JFS features allow 
chkdsk design to balance processing time and workspace size requirements. 
If the workspace was too small, chkdsk would not be able to process the file 
system at all. If chkdsk took to long to process (like the old chkdsk did), it 
would be useless in processing large file systems. The following features 
were selected to achieve a balance between time and size: 

• A portion of the chkdsk workspace is within the file system itself 
dramatically reducing chkdsk’s consumption of dynamic storage. 

• chkdsk optimizes processing for the correct file system at the expense of 
processing time for error cases. 

• This implementation of chkdsk uses 12 bytes per i-node and completes its 
processing in one sequential pass in which all i-nodes are read and one 
sequential pass where only directory i-nodes are read. 

4. 3. 6.1 chkdsk processing flow 

Preliminary: Analyze the parameters specified at invocation. Open the 
aggregate. Determine whether chkdsk has write access. 
Verify/Correct the aggregate superblock. 

Phase 0: Replay the journal log. 

Phase 1 : During Phase 1 , processing consists of validation, recording 

information in the workspace, and recording blocks allocated. 
Initialize the chkdsk workspace. Process aggregate i-nodes. 
Process fileset super i-nodes. If any multiple-allocated blocks 
have been identified at this point, chkdsk exits. Process all fileset 
i-nodes. Count child links. 

Phase 2: Count parent links. 

Phase 3: This phase locates the first reference to any multiple-allocated 
blocks identified as Phase 1. For each directory i-node in use, 
verify that it has only one parent and that the stored parent i-node 
number matches the i-node number of the parent chkdsk 
observed in phase 1 . 

Phase 4: For each i-node record in chkdsk’s workspace i-node map which 

chkdsk has flagged for some kind of repair (excepting a directory 
with illegal hard links), flag any implied repairs. 
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Phase 5: Detect problems related to i-node connectedness. Identify each 
unconnected in-use i-node and flag it for reconnection. Identify 
each directory i-node with multiple parents and flag it for repair. 

Phase 6: Perform all approved i-node corrections. 

Phase 7: Rebuild/Verify i-node allocation maps. 

Phase 8: Rebuild/Verify disk allocation maps. 

Phase 9: Reformat the journal log if journal log replay had an error. 

Final: Refresh redundant copies of the superblock and Aggregate I-node 
Table. 

4.3.7 System limits 

The Majority of the JFS size limits are imposed by the OS/2 kernel and 
system interfaces rather than the JFS itself. These limitations, both actual 
(OS/2 imposed) and potential (the JFS limit), are detailed below: 

Buffer Cache The size of the buffer cache is configurable and is limited by 
the amount of virtual memory that can be allocated to the kernel. This limit is 
approximately 1GB. The JFS cache is designed to support a cache of up to 2 
GB. 



Note 

The default JFS cache size is 12.5 percent of the system's physical 
memory size. To change the JFS default cache size from its default value, 
edit the JFS.IFS statement found in CONFIG.SYS to read: 

DEVICE=C:\OS2\JFS.IFS /CACHE:(XX) /AUTOCHECK:D 
where XX is the size in kilobytes and D: is the JFS volume. 



File System Size The maximum file system size imposed by the width of the 
device driver I/O request interface is 2 TB. Fiowever, the JFS is designed to 
support files of 512 TB (with a block size of 512 bytes) to 4Petabytes (with a 
block size of 4KB). 

File Size The file size limit has been increased to 2 TB; this is imposed 
through the width of the file offsets and sizes beginning at the DOS APIs. The 
JFS file size is governed by the underlining file system. 
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Number of File System Objects The maximum number of files and 
directories within a single JFS system is well over 4 billion. This limit is 
imposed by the JFS and is due to the size of the unique ID (inode number) 
used by the JFS to identify files and directories within a file system, since the 
JFS represents inodes as a standard, unsigned, 32-bit integer. 

Extended Attributes The extended attributes for any single file or directory 
is limited to 64 KB. This limit is imposed by the width of extended attribute 
sizes beginning at the DOS APIs. However, JFS, internally, has a size equal 
to the amount of storage that can be represented through a single extent. The 
size of an extent varies from 8 GB (with a block size of 512 bytes) to 64 GB 
(with a block size of 4 KB). 

4.3.8 Performance considerations 

As already mentioned, the JFS code has been highly optimized for the 32-bit 
environment. Much extra 32-bit code has been introduced into the OS/2 base 
code (such as KEE32 and IFS32; see section 4.2.4 on page 100) so that JFS 
gains performance from the flat 32-bit memory address space. The 32-bit 
implementation has also allowed JFS to scale better in SMP environments. 

Additional APIs have been added to the instruction set to allow TCP/IP 
applications, such as Notes or Web servers, to have gains in performance. 
This results from the direct access some TCP/IP instructions have to data 
stored in the JFS cache. Preliminary tests have shown that JFS serving local 
applications (thus acting as an application server) outperforms HPFS386, 
almost doubling the performance. When used to serve Notes to a large 
number of users, it was shown that the response time of JFS was quicker 
than even Windows NT NTFS. 

Unfortunately, JFS performance as a file and print server is not as easy to 
compare. First, when any performance comparisons between HPFS386 and 
JFS are made, networking consideration need to be removed. The network 
bottleneck will impede server performance long before the file system will, 
thus, a fast network is recommended. In fast networks, it is the hardware 
configuration of the server that is going to govern the choice of file systems. If 
the server is only uniprocessor, JFS can have up to a 40 percent degradation 
over HPFS386. Figure 53 on page 144 is provided to help better understand 
the mechanics of OS/2 Warp Server for e-business as a file server. 

The reason for the difference in file serving throughput between JFS and 
HPFS386 is increased path length for JFS due to the additional ring 
transitions it must do. These extra ring transitions require extra cpu cycles. 
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Examples of paths traced through the system are: 

• Local access to HPFS file in HPFS386 cache: f-g 

• Local access to JFS file in JFS cache: f-h (f-h is faster than f-g) 

• Local access for HPFS file which is not in the HPFS386 cache: f-g-j 

• Local access for JFS file which is not in the JFS cache: f-h-k (this is faster 
than f-g-j) 

• Local access to FAT file: f-i 

• Network access to HPFS file in HPFS386 cache: a-b-c 

• Network access to HPFS file not in HPFS386 cache: a-b-c-j 

• Network access to JFS file in JFS cache (NetBIOS): a-b-d-e-h 

• Network access to JFS file not in JFS cache (NetBIOS): a-b-d-e-h-k 

• Network access to JFS file in JFS cache (TCP/IP): m-n 

• Network access to FAT file: a-b-d-e-i 

JFS scales better in an SMP environment, thus, at 4-way throughput between 
HPFS386 and JFS, it has been shown to be similar, with HPFS386 only 
slightly better, but, in 5-way or better, JFS is expected to excel. If the server 
CPU is underutilized (less than 50 percent free most of the time), JFS 
performance could be equivalent to HPFS386 in 4-way or less scenarios 
because the CPU will have enough time to process the ring transitions. 

Another point that may need to be considered is if the hardware configuration 
provides fault tolerance. If not, then HPFS386 is still the better option since it 
provides RAID-1 (both mirroring and duplexing) fault tolerance. This will need 
to be considered in small server installations. 
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Figure 53. SMB system architecture 



144 Inside OS/2 Warp Server for e-business 



Chapter 5. File and print services 



This chapter describes the File and Print Sharing service of OS/2 Warp 
Server for e-business. The File and Print Sharing Service is a Local Area 
Network application. It allows you to share hardware and software resources 
that are located on the server. Once you have connected to a network 
resource, you may use that resource in the same way as you use a local 
resource. 

The File and Print Service, originally named LAN Server, was a core 
component of OS/2 Warp Server as well as OS/2 Warp Server for e-business. 
There are two comprehensive guides to this service: Inside OS/2 LAN Server 
4.0, SG24-4428, and Inside OS/2 Warp Server: Exploring the Core 
Components, SG24-4602. Both of these books contain in-depth descriptions 
of the File and Print Service. 

The File and Print service component within OS/2 Warp Server for e-business 
contains a number of service and functional rollups. Functional 
enhancements to the File and Print service, available for download from 
software choice, have been integrated into OS/2 Warp Server for e-business. 
They are: 

• IBM Neighborhood Browser Enabler 1.0 for OS/2 Warp Server and OS/2 
Warp Server SMP 

• IBM Networks Client 4.1 for Windows 95 (now includes support for 
Windows 98) 

• IBM Networks Coordinated Client 4.2.3 for Windows NT 

• IBM Networks Primary Logon Client 4.2.3 for Windows NT 

A number of new features have also been included with this release. These 
include: 

• A number of capacity enhancements 

• Support for Multiple Server Names 

• New Command switch (net use /perm) 

• Windows NT Server Integration 

This chapter will attempt to provide a basic overview of the service and focus 
on the rollups and the new features that have been added. The Windows NT 
Server Integration function is described completely in Chapter 6, “Integrating 
Windows NT Servers” on page 181. 
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5.1 Review 



The File and Print service component consists of a number of 
subcomponents. A high level architectural view of the service with all the 
subservices is shown in Figure 54 on page 148. 

Each of these services are programs that are part of LAN Server. The 
available programs are identified in the\IBMLAN\IBMLAN.INI file. To control 
which services are started at startup, as well as the configuration of each of 
the services, edit the IBMLAN.INI file on your workstation. Temporary 
changes to network services can be made through the OS/2 Warp Server 
Administration or the command line (instead of editing the IBMLAN.INI file). 
Using the NET command, services can be started, stopped, and some 
paused and continued. 



Some of the network services are briefly described in the following list. (For 
detailed descriptions of the services, view the on-line guides.) 

Alerter This service notifies selected user IDs when problems 

occur. It also notifies the Generic Alerter service when 
certain LAN problems are detected or anticipated. This 
service cannot be paused. 

DCDB Replicator This service copies the domain control database from a 
primary domain controller to one or more backup domain 
controllers. 



Generic Alerter 



LSserver 



Messenger 

NetLogon 



This service enables the server to build and send Systems 
Network Architecture (SNA) alerts. The Alerter service 
notifies the Generic Alerter service when certain LAN 
problems occur. This service cannot be paused. 

This service provides DOS LAN Services support and 
logical server functions. The logical server supports 
remote requests from clients for activities such as 
spooling, querying users, logon, and logoff. The default 
value for LSserver is to start when OS/2 Warp Server or 
LAN Server is installed. The user should never change the 
default. If you stop LSserver, the Server service 
automatically stops. Therefore, this service should never 
be stopped and cannot be paused. 

This service supports the reception of messages at a 
client or server. This service cannot be paused. 

This service copies the master user and group definitions 
file located on the domain controller to network servers. 
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This service is available only on servers. In order for the 
NetLogon service to replicate user and group definitions 
across servers in a domain, digit 3 of the srvheuristics 
parameter (on domain controllers) and digit 8 of the 
wrkheuristics parameter (on additional servers) must be 
left at their default values. If you change the defaults for 
these parameters, user and group data may not be 
replicated from the domain controller resulting in unknown 
user IDs or group IDs on the additional servers. 

Netrun This service handles requests for running programs 

remotely on a server. 

Network Neighborhood Browser Enabler This service allows OS/2 Warp 
Server to function as a master browser for Windows 
Clients. The master browser function provides Windows 
95 and Windows NT clients the ability to view the domain's 
LAN Server machines and their resources via the Network 
Neighborhood object. 

Remote IPL This service allows the Server service to support remote 
initial program load (remote IPL) of workstations. This 
service corresponds to the Remoteboot section of the 
IBMLAN.INI file. 

Replicator This service copies files from a master location on a 

server to one or more servers or clients requiring a copy of 
the data. This service cannot be paused. 

Requester This service redirects requests for files, printers, and 

serial devices from one workstation to another 
workstation. 

Server This service receives and responds to network requests 

for files, printers, and serial devices. The service checks 
the requests against its database of user IDs and access 
permissions. 

Timesource This service designates a server as a source of a reliable 

time and date with which other workstations on the 
network can synchronize. The Timesource service does 
not keep time. It allows other workstations on the network 
to identify a server with a reliable clock. The default value 
for the Timesource service is to start on domain 
controllers when OS/2 Warp Server or LAN Server is 
installed. This service cannot be paused. 
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UPS 



This service provides protection against power failure. If 
power is interrupted, the UPS service keeps the server 
running until the service can shut down the server safely 
or until an administrator stops the server. 




Ring 3 
Ring 0 



Advanced Server 




OS/2 Kernel 


Redirector 


hpfs368.ifs 




os2krnl 


netwksta.200 



Netbeui 

netbeui.os2 



Figure 54. File and print service, architecture 

The file and print services run at the application privilege level. OS/2 services 
are used to satisfy network file I/O requests session setup and resource 
sharing. All Ring 3 requests include requests for files stored on a FAT, JFS or 
FIPFS partition, print requests, and serial device requests. 

Network file I/O requests from client workstations and responses are sent 
using server message blocks (SMBs). The Server processes SMBs using 
internal network buffers. The IBMLAN.INI file parameters that define the size 
and number of network buffers on the server are sizreqbuf and numreqbuf. 
The IBMLAN.INI file parameters that define the size and number of network 
buffers on the requester are sizworkbuf and numworkbuf. 

An SMB received from the network is copied into the adapter receive buffers 
by the network adapter. The NetBIOS device driver using a global descriptor 
table (GDT) selector copies the data from the adapter’s receive buffers into 
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an available server network buffer. The NetBIOS device driver can 
acknowledge the message or piggyback the acknowledgment on a 
subsequent network message. The PROTOCOL.INI file contains the 
configuration information for the NetBIOS device driver. 

The SMB is passed through the redirector to the server. The redirector is a 
requester component that directs file system request traffic between the 
server, the file system, and the network. Three types of SMB protocols exist 
that can be used for transferring data between a requester and a server: 

• Core SMB protocol 

• Read and Write (RAW) SMB protocol 

• Multiplexed SMB protocol 

The Server is designed to optimize the movement of file I/O from the server to 
the requester. It supports JFS, FAT, HPFS, and HPFS386. For more 
information on these, refer to Chapter 4.1 .6, “Comparison of features of FAT, 
HPFS, and HPFS386 JFS” on page 93. 

The following figures show the overall component structure of the server and 
an OS/2 requester. 
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Figure 55. OS/2 client and server architecture 



5.2 Installation 

The File and Print service can be installed as part of the OS/2 Warp Server 
for e-business integrated installation program. The service can also be 
installed in attended or unattended mode once the base operating system 
has been installed. 
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As described above, the File and Print Services component includes a 
number of supporting services such as Netlogon, Messenger, Alerter, and so 
on. Some of these services are mandatory, and others are optional. The 
installation procedure provides the user with an opportunity to select/deselect 
the services. 



Select the services to install 


Currml Status 


[2 File and Print Sharing Services 


More... Current Version 


^ $ TCP/IP Services 


More... Current Version 


□ Remote Access Services 


Not Installed 


jj||^ ^ Netscape Communicator 


Current Version 


□ Tivoli Management Agent 


Not Installed 


IHfl □ PSnS Backup and Recovery 


Not Installed 


LDAP Toolkit 


Hoie... Not Installed 


j|||j □ Advanced Print Services 


Ho*... Not Installed 


Exit | | Next | Help 





Figure 56. Selective install for networking 

During an attended installation, or when using the Selective Install for 
Network services, the screen shown in Figure 56 on page 151 is displayed. 
This lists all the components that can be selected for installation. One of them 
is the File and Print Services component. 




Figure 57. File and pint services features 
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Figure 57 on page 151 shows the services that can be selected for 
installation. 



5.3 File and print services configuration 

During the configuration process, you are given the opportunity to configure 
the network features, the server name, the domain name, the server role, as 
well as choose a user ID and password. 




Figure 58. File and print services, configuration. 

Selecting the File and Print Sharing Services brings up the File and Print 
Services Configuration Window on the right half of the configuration screen. 

The user can select the installation drive where these services can be 
installed. The Default drive is the drive where the operating system is 
installed. 

The server role has to be specified. A server in a domain can take on different 
roles. 

Domain Controller: There should be only one Domain Controller in the 
domain. This is crucial for the domain because it maintains the user database 
and does the validation of users and servers. 

Backup Server: This server has a read only copy of the user database, which 
is constantly replicated from the Domain Controller. The Backup server also 
handles logon validation. 
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Additional server: Additional server cannot perform logon validation. It uses 
and shares the data on the network 

Depending on the type of server that has to be installed, select the role. 
Domain Controller is the default selected server role. 

The name of the server and the domain into which this server has to be 
configured have to be entered. 

Note 

The Server name must be unique in the Network. If the server role is 
Primary Domain Controller, the Domain name must also be unique. 




Figure 59. File and print services, selecting a network adapter. 

The Austostart section gives the user the choice of selecting the services that 
need to be started at server startup time. Services that are not started at 
server startup can be started manually from the command line. 
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Configuration 
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Figure 60. Autostart configuration 

After the Installation and configuration is complete, the following icon is 
added to the desktop: 




Figure 61. File and print services icon 
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